List Connections

List connected social accounts with platform info and token status.

Request

Retrieve all connected social accounts for the authenticated user. Disconnected accounts are automatically filtered out.

Permission required: posts:read

Query Parameters

limitintegerOptional

Default: 20

Maximum number of connections to return per page. Range: 1–50.

offsetintegerOptional

Default: 0

Number of connections to skip. Used for pagination.

platformstringRequired

Filter by platform. Values: TWITTER, INSTAGRAM, LINKEDIN, FACEBOOK, TIKTOK, YOUTUBE, PINTEREST, SNAPCHAT. Case-insensitive.

Example Request

curl "https://app.ewasl.com/api/v1/connections" \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

curl "https://app.ewasl.com/api/v1/connections?platform=twitter" \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

Response

Returns a paginated list of connection objects.

dataarray

List of connection objects.

metaobject

Pagination metadata with total, offset, limit, and next fields.

Usage

The id field from each connection is what you pass as accountIds when creating posts. For example:

{
  "content": "Hello world!",
  "accountIds": ["id-from-connections-endpoint"],
  "publishNow": true
}

Response Example

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "platform": "twitter",
      "accountId": "123456789",
      "accountName": "@ewasl_official",
      "status": "connected",
      "expiresAt": "2026-06-01T00:00:00Z",
      "connectedAt": "2026-01-15T10:00:00Z"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "platform": "linkedin",
      "accountId": "urn:li:organization:12345",
      "accountName": "eWasl Company Page",
      "status": "connected",
      "expiresAt": null,
      "connectedAt": "2026-01-15T10:05:00Z"
    },
    {
      "id": "7cb8c921-0ebe-22e2-91c5-11d15fe541d9",
      "platform": "instagram",
      "accountId": "987654321",
      "accountName": "ewasl.social",
      "status": "expired",
      "expiresAt": "2026-02-28T00:00:00Z",
      "connectedAt": "2026-01-15T10:10:00Z"
    }
  ],
  "meta": {
    "total": 3,
    "offset": 0,
    "limit": 20,
    "next": null
  }
}