API reference
Move an account to another profile, or out of any profile.
https://api.betterpost.dev/v1/connect/integrations/{id}| Name | Description |
|---|---|
id | The account id. |
| Field | Type | Required | Description |
|---|---|---|---|
profileId | string or null | Yes | The destination profile, or null for no profile. No other fields are accepted. |
curl -s -X PATCH https://api.betterpost.dev/v1/connect/integrations/acc_2x9c4v7b1n8m3k5j0h6g2f4d \
-H "x-access-key: $BETTERPOST_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileId": "prof_1b7r4a9n2d5c8l0e3k6s9m2x" }'200 OK
{
"success": true,
"integration": {
"id": "acc_2x9c4v7b1n8m3k5j0h6g2f4d",
"platform": "twitter",
"platformUserId": "sbx_4829105736",
"username": "@demo_brand",
"displayName": "Demo Brand",
"imageUrl": "https://api.dicebear.com/9.x/initials/svg?seed=%40demo_brand",
"profileId": "prof_1b7r4a9n2d5c8l0e3k6s9m2x",
"authStatus": "active",
"sandbox": true,
"createdAt": "2026-10-21T14:05:40.031Z"
}
}| Status | Code | When |
|---|---|---|
200 | The account was moved. | |
400 | validation_error | profileId is missing, or another field was sent. |
401 | unauthorized | Missing or unknown API key. |
404 | not_found | The account or the destination profile does not exist. |
409 | duplicate_integration | The destination profile already has this same account. |
429 | rate_limited | More than 120 requests per minute. |