Accounts

Get a connect link

Check whether a connect link was used, and which accounts it connected.

GET https://social-publish-api.onrender.com/v1/accounts/connect-links/{id}

Returns a connect link and its outcome. Call it from your server after your user comes back to your redirectUrl, to confirm the result before you trust it.

Path parameters

Parameter	Description
`id`	The link's `id` from Create a connect link.

Request

cURLNode.jsPython

curl https://social-publish-api.onrender.com/v1/accounts/connect-links/5b0c7e1a-2f3d-4c5b-8a9e-1d2c3b4a5f6e \
  -H "x-access-key: $RELAYCAST_API_KEY"

const res = await fetch(`https://social-publish-api.onrender.com/v1/accounts/connect-links/${linkId}`, {
  headers: { "x-access-key": process.env.RELAYCAST_API_KEY! },
});
const { data: link } = await res.json();
if (link.status === "connected") console.log("Connected accounts:", link.accountIds);

import os, requests

res = requests.get(
    f"https://social-publish-api.onrender.com/v1/accounts/connect-links/{link_id}",
    headers={"x-access-key": os.environ["RELAYCAST_API_KEY"]},
)
link = res.json()["data"]

Response

The same fields as when the link was created, without url.

Response 200

{
  "data": {
    "id": "5b0c7e1a-2f3d-4c5b-8a9e-1d2c3b4a5f6e",
    "platform": "youtube",
    "status": "connected",
    "accountIds": ["7c6b5a49-3827-4e1d-8c0b-9a8f7e6d5c4b"],
    "error": null,
    "errorDetail": null,
    "redirectUrl": "https://app.example.com/integrations/done",
    "state": "user_42",
    "groupId": null,
    "oauthAppId": null,
    "expiresAt": "2026-11-02T10:00:00.000Z",
    "completedAt": "2026-11-02T09:03:12.000Z",
    "createdAt": "2026-11-02T09:00:00.000Z"
  }
}

`status`	Meaning
`pending`	Created, not opened yet.
`opened`	The user opened the link and is on the consent screen.
`connected`	Done. `accountIds` lists the connected accounts.
`failed`	Done, with an `error` (and sometimes `errorDetail`). See the error codes.
`expired`	Not used before `expiresAt`.

Returns 404 not_found if the id doesn't exist or belongs to another project.

This page is also available as Markdown.