Skip to main content
POST
Create a new source link for a job. Each source produces a unique URL that can be shared on a specific platform (LinkedIn post, internal referral page, Indeed listing, etc.) — visits to that URL are tracked separately, so you can attribute applicants back to the source they came from. The endpoint is idempotent on (job_id, source_name): posting twice with the same job and source name returns the existing source link instead of erroring or creating a duplicate.

Authentication

string
required
Bearer authentication header of the form Bearer <token>.

Request Body

string
required
The job UUID to attach the source to. The job must belong to your workspace.
string
required
Human-readable label for the source. Free-form — common values: LinkedIn, Indeed, Referral, Careers Page, Twitter. Trimmed to remove leading/trailing whitespace.

Response

boolean
object
The created (or existing, if idempotent hit) source link.

Error Responses

400 Bad Request

401 Unauthorized

404 Not Found