Skip to main content
POST
/
v1
/
accounts
/
connect
/
{platform}
Start a connect flow
curl --request POST \
  --url https://api.letmepost.dev/v1/accounts/connect/{platform} \
  --header 'Content-Type: application/json' \
  --data '
{
  "profileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "descriptor": {}
}

Path Parameters

​
platform
enum<string>
required

Supported platforms. tiktok is currently in App Review — connect requests return platform_not_enabled until approval lands.

Available options:
bluesky,
facebook,
instagram,
linkedin,
pinterest,
threads,
tiktok,
twitter

Body

application/json
​
profileId
string<uuid>

Land the resulting account in this profile. Falls back to the org's default profile when omitted.

Response

Connect descriptor.

Describes how to finish a connect for :platform. OAuth platforms return an authorizationUrl; Bluesky returns a form schema for the credentials surface.

​
platform
enum<string>
required

Supported platforms. tiktok is currently in App Review — connect requests return platform_not_enabled until approval lands.

Available options:
bluesky,
facebook,
instagram,
linkedin,
pinterest,
threads,
tiktok,
twitter
​
state
enum<string>
required

Platform enablement state. pending rejects connect with platform_not_enabled.

Available options:
stable,
trial,
pending
​
descriptor
object
required

Provider-specific connect descriptor — OAuth URL for OAuth platforms, form schema for credential platforms.