Prospect sources

Look up the sources you can record against prospect contacts and Prospect Companies.

A prospect source records where a prospect contact or Prospect Company came from, such as your website or a trade show. Use a source's id as source_id on prospect contacts and Prospect Companies.

These endpoints are read-only and use the prospects:read scope.

The prospect source object#

{
  "id": "rls_website",
  "code": "WEBSITE",
  "name": "Website",
  "description": "Inbound from company website",
  "sort_order": 1,
  "is_active": true,
  "created_at": "2026-02-09T00:00:00.000Z",
  "updated_at": "2026-02-09T00:00:00.000Z"
}

Signal's standard sources:

List prospect sources#

GET /prospect-sources · Scope: prospects:read

Returns Signal's standard prospect sources in one response (meta.hasMore is always false). Sources your workspace added itself aren't included in this list, but you can fetch them by ID.

Example#

curl https://crm.empiraa.app/api/v1/prospect-sources \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://crm.empiraa.app/api/v1/prospect-sources", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const { data } = await res.json();

Response 200#

{
  "data": [
    { "id": "rls_website", "code": "WEBSITE", "name": "Website", "description": "Inbound from company website", "sort_order": 1, "is_active": true, "created_at": "2026-02-09T00:00:00.000Z", "updated_at": "2026-02-09T00:00:00.000Z" },
    { "id": "rls_referral", "code": "REFERRAL", "name": "Referral", "description": "Referred by existing customer or partner", "sort_order": 2, "is_active": true, "created_at": "2026-02-09T00:00:00.000Z", "updated_at": "2026-02-09T00:00:00.000Z" }
  ],
  "meta": { "cursor": null, "hasMore": false },
  "error": null
}

Get a prospect source#

GET /prospect-sources/{id} · Scope: prospects:read

Returns a standard source or one of your workspace's own sources.

Path parameters#

Example#

curl https://crm.empiraa.app/api/v1/prospect-sources/rls_website \
  -H "Authorization: Bearer YOUR_API_KEY"

await fetch("https://crm.empiraa.app/api/v1/prospect-sources/rls_website", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

Response 200#

The prospect source object in data.

Errors#