Start a connect flow
Dashboard session only. Returns a ConnectDescriptor describing how to finish the connect — an OAuth authorization URL for OAuth platforms, or a credentials form schema for Bluesky. Programmatic API keys cannot mint OAuth state.
curl --request POST \
--url https://api.letmepost.dev/v1/accounts/connect/{platform} \
--header 'Content-Type: application/json' \
--data '
{
"profileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.letmepost.dev/v1/accounts/connect/{platform}"
payload = { "profileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({profileId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.letmepost.dev/v1/accounts/connect/{platform}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.letmepost.dev/v1/accounts/connect/{platform}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'profileId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.letmepost.dev/v1/accounts/connect/{platform}"
payload := strings.NewReader("{\n \"profileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.letmepost.dev/v1/accounts/connect/{platform}")
.header("Content-Type", "application/json")
.body("{\n \"profileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.letmepost.dev/v1/accounts/connect/{platform}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"profileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"descriptor": {}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}Path Parameters
Supported platforms. tiktok is currently in App Review — connect requests return platform_not_enabled until approval lands.
bluesky, facebook, instagram, linkedin, pinterest, threads, tiktok, twitter Body
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.
Supported platforms. tiktok is currently in App Review — connect requests return platform_not_enabled until approval lands.
bluesky, facebook, instagram, linkedin, pinterest, threads, tiktok, twitter Platform enablement state. live is production-ready; trial connects but the upstream is sandboxed or rate-capped; pending rejects connect with platform_not_enabled.
live, trial, pending Provider-specific connect descriptor — OAuth URL for OAuth platforms, form schema for credential platforms.
Was this page helpful?
curl --request POST \
--url https://api.letmepost.dev/v1/accounts/connect/{platform} \
--header 'Content-Type: application/json' \
--data '
{
"profileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.letmepost.dev/v1/accounts/connect/{platform}"
payload = { "profileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({profileId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.letmepost.dev/v1/accounts/connect/{platform}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.letmepost.dev/v1/accounts/connect/{platform}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'profileId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.letmepost.dev/v1/accounts/connect/{platform}"
payload := strings.NewReader("{\n \"profileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.letmepost.dev/v1/accounts/connect/{platform}")
.header("Content-Type", "application/json")
.body("{\n \"profileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.letmepost.dev/v1/accounts/connect/{platform}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"profileId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"descriptor": {}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}{
"error": {
"code": "preflight_failed",
"message": "Bluesky posts are capped at 300 graphemes; this body is 312.",
"rule": "bluesky.text.max_graphemes",
"platform": "bluesky",
"remediation": "Trim 12 graphemes, or split into a thread.",
"docUrl": "https://docs.letmepost.dev/errors/preflight_failed",
"ruleUrl": "https://docs.letmepost.dev/preflight/bluesky-text-max_graphemes",
"requestId": "req_01HY6X4AWBJM2K9F2PTQMRD9JQ"
}
}
