Add a page to ask for a link from
Posting the same source_url again updates the existing prospect instead of duplicating it.
POST
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/link-prospectsRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
source_urlstringrequiredPage you want a link from.
target_urlstringPage on the site the link should point to.
contact_namestringWho to ask.
contact_emailstringTheir email.
suggested_anchorstringAnchor text to ask for.
statusstringOutreach state.
owner_user_idintegerMember who owns the outreach.
notesstringFree-text notes.
next_follow_up_onstringDate of the next follow-up (YYYY-MM-DD).
Response
Response Body
idstringProspect id. Use it as prospect_id.source_urlstringPage you want a link from.source_domainstringDomain of that page.contact_namestring | nullWho to ask.contact_emailstring | nullTheir email.target_urlstring | nullPage on the site the link should point to.suggested_anchorstring | nullAnchor text to ask for.statusstringOutreach state.sourcestringWhere the prospect came from: added by hand, a brand mention, the API, an import, or a site an AI answer cited.owner_user_idinteger | nullMember chasing it.notesstring | nullFree-text notes.next_follow_up_onstring | nullWhen the next follow-up is due.last_verified_atstring | nullLast time the page was checked for the link.verification_statusstring | nullResult of the last check.backlink_idstring | nullBacklink created once the link went live.created_atstringCreation time.updated_atstringLast change.Request
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/link-prospects \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "source_url": "https://partner.example.org/resources", "target_url": "https://acmebakery.co.uk/guides/sourdough", "contact_name": "Jo Baker", "contact_email": "jo@partner.example.org", "suggested_anchor": "sourdough starter guide", "notes": "Met at the food fair.", "next_follow_up_on": "2026-09-20"}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 201
{ "data": { "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "source_url": "https://partner.example.org/resources", "source_domain": "partner.example.org", "contact_name": "Jo Baker", "contact_email": "jo@partner.example.org", "target_url": null, "suggested_anchor": null, "status": "prospect", "source": "manual", "owner_user_id": 12, "notes": null, "next_follow_up_on": null, "last_verified_at": null, "verification_status": "missing", "backlink_id": null, "created_at": "2026-09-01T09:00:00.000Z", "updated_at": "2026-09-01T09:00:00.000Z" }}