staqlydocs
REST APIAPI referenceChannels

Connect the picked accounts, each as its own channel

Connect the picked accounts, each as its own channel (channels:manage)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

POST
/v1/pending-connections/{id}

Every picked account becomes a channel; one already connected (the same account) is reconnected instead. The sign-in is used once: to pick again, connect again. The plan's channel limit applies to each new channel.

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Replays the stored response when the same key is repeated with the same method, path, query string and body within 24 hours (422 idempotency_mismatch with a different request, 409 idempotency_in_progress while the first one runs). Not applied to multipart uploads or to responses that carry a secret.

Lengthlength <= 200

Request Body

application/json
  1. body
account_ids*array<string>

Ids from the pending connection's accounts

Items1 <= items

Response Body

Connected

application/json
  1. response
data*array<>
Example Request
curl -X POST 'https://staqly.example.com/v1/pending-connections/string' \  -H 'Content-Type: application/json' \  -d '{  "account_ids": [    "string"  ]}'
Example Response
{  "data": [    {      "id": "string",      "provider": "string",      "name": "string",      "handle": "string",      "avatar_url": "string",      "profile_url": "string",      "status": "connected",      "settings": {},      "links": "keep",      "group_id": "string",      "last_error": "string",      "comments": true,      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "activity": {        "last_published_at": "2019-08-24T14:15:22Z",        "last_post_id": "string",        "next_publish_at": "2019-08-24T14:15:22Z",        "published_30d": 0      }    }  ]}