curl --request POST \
--url https://api.openpmm.com/v1/workspaces/{workspace_id}/destination-connection-sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"provider": "x"
}
'{
"id": "dcs_01JABCDEF",
"object": "destination_connection_session",
"provider": "x",
"status": "pending",
"authorization_url": "<string>",
"expires_at": "2026-08-09T12:00:00.000Z",
"selection_required": true,
"completed_at": "2026-08-09T12:00:00.000Z",
"failure_code": "<string>",
"failed_at": "2026-08-09T12:00:00.000Z"
}Start Destination Connection
Start the provider authorization flow. Open authorization_url in a browser. Then use the session endpoint to check the status. The request schema lists all supported providers.
curl --request POST \
--url https://api.openpmm.com/v1/workspaces/{workspace_id}/destination-connection-sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"provider": "x"
}
'{
"id": "dcs_01JABCDEF",
"object": "destination_connection_session",
"provider": "x",
"status": "pending",
"authorization_url": "<string>",
"expires_at": "2026-08-09T12:00:00.000Z",
"selection_required": true,
"completed_at": "2026-08-09T12:00:00.000Z",
"failure_code": "<string>",
"failed_at": "2026-08-09T12:00:00.000Z"
}Authorizations
Send an account API key in the Authorization: Bearer <key> header.
Headers
Optional request ID. OpenPMM returns this value when it is valid. Otherwise, OpenPMM creates a request ID.
128A unique key for this operation. Use the same key when you retry the same request. Different input with the same key returns 409.
1 - 200Path Parameters
Unique workspace ID.
"ws_01JABCDEF"
Body
Provider to connect.
bluesky, x, youtube, facebook, instagram, threads, mastodon, linkedin, tiktok "x"
Required only for Mastodon. Use the instance origin.
"https://mastodon.social"
Required only for Bluesky. Use the account handle or DID.
"alice.bsky.social"
Response
A pending provider connection session.
Unique connection session ID.
"dcs_01JABCDEF"
Object type.
"destination_connection_session"Social provider.
bluesky, x, youtube, facebook, instagram, threads, mastodon, linkedin, tiktok "x"
Current authorization flow status.
pending, completed, failed, expired URL that a person must open to authorize the provider.
Time when the pending session expires.
"2026-08-09T12:00:00.000Z"
Whether you must select a Facebook Page before you can create Facebook posts.
Time when authorization completed.
"2026-08-09T12:00:00.000Z"
Stable failure code when authorization fails.
Time when authorization failed.
"2026-08-09T12:00:00.000Z"