# Platform tools API

> Network-specific tools on a connected account: Google Business Profile listing, reviews, media and verification; Facebook Pages; LinkedIn organizations and mentions; Instagram stories, audio and discovery; Pinterest boards; YouTube playlists and transcripts; Reddit subreddits, flairs and votes; TikTok creator info; Discord server management; Bluesky settings.

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## List Google Business reviews

`GET /accounts/{accountId}/gmb-reviews`

Reviews of the location with average rating and total count (cursor paging, ≤50 per page). Optional location_id targets another location of the same Google login.

Access: `read` · MCP tool: `list-gmb-reviews` · Zernio: `GET /v1/accounts/{accountId}/gmb-reviews`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `limit` (integer; 1–50)
- `cursor` (string; ≤ 2048 characters)
- `order_by` (string; one of update_time desc, updateTime desc, rating, rating desc)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "location_id": "string",
  "average_rating": 1.5,
  "total_review_count": 1,
  "data": [
    {
      "object": "gmb_review",
      "id": "string",
      "name": "string",
      "location_id": "string",
      "rating": 1,
      "text": "string",
      "text_translated": "string",
      "text_original": "string",
      "author": "string",
      "author_avatar_url": "https://example.com",
      "author_is_anonymous": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "has_reply": true,
      "reply": "string",
      "reply_updated_at": "2026-10-13T09:00:00.000Z",
      "reply_state": "string",
      "reply_policy_violation": {},
      "reply_url": "https://example.com",
      "has_photos": true,
      "photo_count": 1,
      "media": [
        {
          "type": "string",
          "url": "https://example.com",
          "thumbnail_url": "https://example.com"
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Batch get Google Business reviews

`POST /accounts/{accountId}/gmb-reviews/batch`

Reviews across up to 50 locations of the same Google account in one call.

Access: `read` · MCP tool: `batch-get-gmb-reviews` · Zernio: `POST /v1/accounts/{accountId}/gmb-reviews/batch`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_ids` (array of string; required; 1–50 items)
- `google_account_id` (string; ≤ 300 characters)
- `limit` (integer; 1–50)
- `cursor` (string; ≤ 2048 characters)
- `order_by` (string; one of update_time desc, updateTime desc, rating, rating desc)
- `ignore_rating_only_reviews` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews/batch" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_ids": [
      "string"
    ],
    "google_account_id": "string",
    "limit": 1,
    "cursor": "string",
    "order_by": "update_time desc"
  }'
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "google_account_id": "string",
  "data": [
    {
      "object": "gmb_location_review",
      "location_id": "string",
      "review": {
        "object": "gmb_review",
        "id": "string",
        "name": "string",
        "location_id": "string",
        "rating": 1,
        "text": "string"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Get a Google Business review

`GET /accounts/{accountId}/gmb-reviews/{reviewId}`

Access: `read` · MCP tool: `get-gmb-review` · Zernio: `GET /v1/accounts/{accountId}/gmb-reviews/{reviewId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `reviewId` (string; required; 1–512 characters)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews/REVIEW_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_review",
  "id": "string",
  "name": "string",
  "location_id": "string",
  "rating": 1,
  "text": "string",
  "text_translated": "string",
  "text_original": "string",
  "author": "string",
  "author_avatar_url": "https://example.com",
  "author_is_anonymous": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "has_reply": true,
  "reply": "string",
  "reply_updated_at": "2026-10-13T09:00:00.000Z",
  "reply_state": "string",
  "reply_policy_violation": {},
  "reply_url": "https://example.com",
  "has_photos": true,
  "photo_count": 1,
  "media": [
    {
      "type": "string",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ]
}
```

## Reply to a Google Business review

`POST /accounts/{accountId}/gmb-reviews/{reviewId}/reply`

Creates or overwrites the owner reply (≤4096 bytes). Set automated: true for replies sent without a human pressing send (AI agents, workflows); they need the location opt-in (PATCH …/gmb-automation) and are audited. Emits review.replied.

Access: `write` · MCP tool: `reply-to-gmb-review` · Zernio: `POST /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `reviewId` (string; required; 1–512 characters)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `comment` (string; required; 1–4096 characters)
- `automated` (boolean): true when no human pressed send (AI agents, workflows, auto-responders); needs the location opt-in
- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews/REVIEW_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string",
    "automated": false,
    "location_id": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_review_reply",
  "review_id": "string",
  "name": "string",
  "comment": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "reply_state": "string",
  "automated": true,
  "deleted": true
}
```

## Delete a Google Business review reply

`DELETE /accounts/{accountId}/gmb-reviews/{reviewId}/reply`

Access: `write` · MCP tool: `delete-gmb-review-reply` · Zernio: `DELETE /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `reviewId` (string; required; 1–512 characters)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews/REVIEW_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_review_reply",
  "review_id": "string",
  "name": "string",
  "comment": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "reply_state": "string",
  "automated": true,
  "deleted": true
}
```

## Get the Google Business automation opt-in

`GET /accounts/{accountId}/gmb-automation`

Whether the business opted in to automated review replies / listing edits for the location (Google policy).

Access: `read` · MCP tool: `get-gmb-automation`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-automation" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_automation",
  "id": "string",
  "account_id": "string",
  "location_id": "string",
  "automated_review_replies": true,
  "automated_listing_edits": true,
  "consent_text": "string",
  "opted_in_by": {
    "type": "string",
    "id": "string",
    "name": "string"
  },
  "opted_in_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Update the Google Business automation opt-in

`PATCH /accounts/{accountId}/gmb-automation`

Record (or revoke) the business’s express opt-in for automated review replies and listing edits on a location. Every change is written to the automation audit log.

Access: `write` · MCP tool: `update-gmb-automation`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `automated_review_replies` (boolean)
- `automated_listing_edits` (boolean)
- `consent_text` (string | null; ≤ 2000 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-automation" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "automated_review_replies": true,
    "automated_listing_edits": true,
    "consent_text": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_automation",
  "id": "string",
  "account_id": "string",
  "location_id": "string",
  "automated_review_replies": true,
  "automated_listing_edits": true,
  "consent_text": "string",
  "opted_in_by": {
    "type": "string",
    "id": "string",
    "name": "string"
  },
  "opted_in_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## List the Google Business automation audit log

`GET /accounts/{accountId}/gmb-automation/audit-log`

Opt-in changes and automated actions (automated review replies) for the account, newest first.

Access: `read` · MCP tool: `list-gmb-automation-audit`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `page` (integer; ≥ 1)
- `limit` (integer; 1–100)
- `action` (string; one of opt_in_review_replies, opt_out_review_replies, opt_in_listing_edits, opt_out_listing_edits, automated_review_reply)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-automation/audit-log" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "gmb_automation_audit",
      "id": "string",
      "account_id": "string",
      "location_id": "string",
      "action": "string",
      "actor": {
        "type": "string",
        "id": "string",
        "name": "string"
      },
      "details": {},
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Get Google Business location details

`GET /accounts/{accountId}/gmb-location-details`

The Business Information Location (title, address, hours, categories, profile, phone, website…) plus status flags. Optional location_id targets another location of the same Google login.

Access: `read` · MCP tool: `get-gmb-location-details` · Zernio: `GET /v1/accounts/{accountId}/gmb-location-details`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `read_mask` (string; ≤ 2000 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-location-details" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_location_details",
  "account_id": "string",
  "location_id": "string",
  "flags": {},
  "location": {},
  "update_mask": [
    "string"
  ],
  "validate_only": true,
  "warnings": [
    "string"
  ]
}
```

## Update Google Business location details

`PATCH /accounts/{accountId}/gmb-location-details`

PATCH native Location fields (snake_case). update_mask is inferred from the body keys when omitted; validate_only dry-runs. Title / address / category edits may trigger re-verification (see warnings). Rate limited to 10 edits/min/location.

Access: `write` · MCP tool: `update-gmb-location-details` · Zernio: `PUT /v1/accounts/{accountId}/gmb-location-details`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `update_mask` (string | array of string)
- `validate_only` (boolean)
- `title` (string)
- `regular_hours` (object)
- `special_hours` (object)
- `more_hours` (array of object)
- `profile` (object)
- `website_uri` (string)
- `phone_numbers` (object)
- `categories` (object)
- `service_items` (array of object)
- `store_code` (string)
- `labels` (array of string)
- `storefront_address` (object)
- `service_area` (object)
- `open_info` (object)
- `latlng` (object)
- `ad_words_location_extensions` (object)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-location-details" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "update_mask": "string",
    "validate_only": true,
    "title": "string",
    "regular_hours": {}
  }'
```

Response 200:

```json
{
  "object": "gmb_location_details",
  "account_id": "string",
  "location_id": "string",
  "flags": {},
  "location": {},
  "update_mask": [
    "string"
  ],
  "validate_only": true,
  "warnings": [
    "string"
  ]
}
```

## Get Google Business attributes

`GET /accounts/{accountId}/gmb-attributes`

Access: `read` · MCP tool: `get-gmb-attributes` · Zernio: `GET /v1/accounts/{accountId}/gmb-attributes`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-attributes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_attributes",
  "account_id": "string",
  "location_id": "string",
  "attributes": [
    {}
  ],
  "attribute_mask": [
    "string"
  ]
}
```

## Update Google Business attributes

`PATCH /accounts/{accountId}/gmb-attributes`

attribute_mask defaults to the given attribute names; masked names missing from attributes are cleared.

Access: `write` · MCP tool: `update-gmb-attributes` · Zernio: `PUT /v1/accounts/{accountId}/gmb-attributes`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `attributes` (array of object; required; ≤ 500 items)
  - `attributes[].name` (string; required; ≥ 1 characters)
  - `attributes[].values` (array of any)
  - `attributes[].repeated_enum_value` (object)
  - `attributes[].uri_values` (array of any)
- `attribute_mask` (string | array of string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-attributes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "attributes": [
      {
        "name": "string",
        "values": [
          null
        ]
      }
    ],
    "attribute_mask": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_attributes",
  "account_id": "string",
  "location_id": "string",
  "attributes": [
    {}
  ],
  "attribute_mask": [
    "string"
  ]
}
```

## Get Google Business attribute metadata

`GET /accounts/{accountId}/gmb-attribute-metadata`

Attributes available for the location, or for a category (category_name + region_code).

Access: `read` · MCP tool: `get-gmb-attribute-metadata` · Zernio: `GET /v1/accounts/{accountId}/gmb-attribute-metadata`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `category_name` (string; ≤ 300 characters)
- `region_code` (string; ≤ 8 characters)
- `language_code` (string; ≤ 35 characters)
- `show_all` (boolean)
- `limit` (integer; 1–200)
- `cursor` (string; ≤ 2048 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-attribute-metadata" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "location_id": "string",
  "data": [
    {}
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Get Google Business services

`GET /accounts/{accountId}/gmb-services`

Access: `read` · MCP tool: `get-gmb-services` · Zernio: `GET /v1/accounts/{accountId}/gmb-services`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-services" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_services",
  "account_id": "string",
  "location_id": "string",
  "services": [
    {}
  ],
  "categories": {}
}
```

## Replace Google Business services

`PATCH /accounts/{accountId}/gmb-services`

Access: `write` · MCP tool: `replace-gmb-services` · Zernio: `PUT /v1/accounts/{accountId}/gmb-services`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `service_items` (array of object; required; ≤ 500 items)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-services" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "service_items": [
      {}
    ]
  }'
```

Response 200:

```json
{
  "object": "gmb_services",
  "account_id": "string",
  "location_id": "string",
  "services": [
    {}
  ],
  "categories": {}
}
```

## Get Google Business food menus

`GET /accounts/{accountId}/gmb-food-menus`

Access: `read` · MCP tool: `get-gmb-food-menus` · Zernio: `GET /v1/accounts/{accountId}/gmb-food-menus`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-food-menus" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_food_menus",
  "account_id": "string",
  "location_id": "string",
  "name": "string",
  "menus": [
    {}
  ]
}
```

## Update Google Business food menus

`PATCH /accounts/{accountId}/gmb-food-menus`

Access: `write` · MCP tool: `update-gmb-food-menus` · Zernio: `PUT /v1/accounts/{accountId}/gmb-food-menus`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `menus` (array of object; required)
- `update_mask` (string; ≤ 500 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-food-menus" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "menus": [
      {}
    ],
    "update_mask": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_food_menus",
  "account_id": "string",
  "location_id": "string",
  "name": "string",
  "menus": [
    {}
  ]
}
```

## List Google Business photos and videos

`GET /accounts/{accountId}/gmb-media`

Access: `read` · MCP tool: `list-gmb-media` · Zernio: `GET /v1/accounts/{accountId}/gmb-media`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `limit` (integer; 1–100)
- `cursor` (string; ≤ 2048 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "location_id": "string",
  "total": 1,
  "data": [
    {
      "object": "gmb_media",
      "id": "string",
      "name": "string",
      "media_format": "string",
      "source_url": "https://example.com",
      "google_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "description": "string",
      "create_time": "string",
      "location_association": {},
      "dimensions": {},
      "insights": {},
      "attribution": {},
      "warnings": [
        "string"
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Upload a Google Business photo or video

`POST /accounts/{accountId}/gmb-media`

Upload by public URL (photos 10 KB–5 MB, ≥250 px; videos ≤30 s, ≤75 MB).

Access: `write` · MCP tool: `upload-gmb-media` · Zernio: `POST /v1/accounts/{accountId}/gmb-media`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `source_url` (string; required; 8–4096 characters, pattern ^https?://)
- `media_format` (string; one of PHOTO, VIDEO)
- `category` (string; one of CATEGORY_UNSPECIFIED, COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, …)
- `description` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "source_url": "https://example.com",
    "media_format": "PHOTO",
    "category": "CATEGORY_UNSPECIFIED",
    "description": "string"
  }'
```

Response 201:

```json
{
  "object": "gmb_media",
  "id": "string",
  "name": "string",
  "media_format": "string",
  "source_url": "https://example.com",
  "google_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "description": "string",
  "create_time": "string",
  "location_association": {},
  "dimensions": {},
  "insights": {},
  "attribution": {},
  "warnings": [
    "string"
  ]
}
```

## Delete a Google Business photo or video

`DELETE /accounts/{accountId}/gmb-media`

Access: `write` · MCP tool: `delete-gmb-media` · Zernio: `DELETE /v1/accounts/{accountId}/gmb-media`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `media_id` (string; required; 1–500 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-media?media_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_media",
  "id": "string",
  "name": "string",
  "deleted": true
}
```

## List Google Business action links

`GET /accounts/{accountId}/gmb-place-actions`

Access: `read` · MCP tool: `list-gmb-place-actions` · Zernio: `GET /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `limit` (integer; 1–100)
- `cursor` (string; ≤ 2048 characters)
- `filter` (string; ≤ 500 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-place-actions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "location_id": "string",
  "data": [
    {
      "object": "gmb_place_action_link",
      "id": "string",
      "name": "string",
      "uri": "string",
      "place_action_type": "string",
      "is_preferred": true,
      "is_editable": true,
      "provider_type": "string",
      "create_time": "string",
      "update_time": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Create a Google Business action link

`POST /accounts/{accountId}/gmb-place-actions`

Access: `write` · MCP tool: `create-gmb-place-action` · Zernio: `POST /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `uri` (string; required; 8–4096 characters, pattern ^https?://)
- `place_action_type` (string; required; one of APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE, SOLOPRENEUR_APPOINTMENT)
- `is_preferred` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-place-actions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "uri": "xxxxxxxx",
    "place_action_type": "APPOINTMENT",
    "is_preferred": true
  }'
```

Response 201:

```json
{
  "object": "gmb_place_action_link",
  "id": "string",
  "name": "string",
  "uri": "string",
  "place_action_type": "string",
  "is_preferred": true,
  "is_editable": true,
  "provider_type": "string",
  "create_time": "string",
  "update_time": "string"
}
```

## Update a Google Business action link

`PATCH /accounts/{accountId}/gmb-place-actions`

Access: `write` · MCP tool: `update-gmb-place-action` · Zernio: `PATCH /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `name` (string; required; 1–500 characters)
- `uri` (string; 8–4096 characters, pattern ^https?://)
- `place_action_type` (string; one of APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE, SOLOPRENEUR_APPOINTMENT)
- `is_preferred` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-place-actions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "name": "string",
    "uri": "xxxxxxxx",
    "place_action_type": "APPOINTMENT",
    "is_preferred": true
  }'
```

Response 200:

```json
{
  "object": "gmb_place_action_link",
  "id": "string",
  "name": "string",
  "uri": "string",
  "place_action_type": "string",
  "is_preferred": true,
  "is_editable": true,
  "provider_type": "string",
  "create_time": "string",
  "update_time": "string"
}
```

## Delete a Google Business action link

`DELETE /accounts/{accountId}/gmb-place-actions`

Access: `write` · MCP tool: `delete-gmb-place-action` · Zernio: `DELETE /v1/accounts/{accountId}/gmb-place-actions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `name` (string; required; 1–500 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-place-actions?name=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_place_action_link",
  "id": "string",
  "name": "string",
  "deleted": true
}
```

## Get Google Business verification state

`GET /accounts/{accountId}/gmb-verifications`

Voice of Merchant state, a summary (live, needs_verification, …) and the verifications of the location.

Access: `read` · MCP tool: `get-gmb-verifications` · Zernio: `GET /v1/accounts/{accountId}/gmb-verifications`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-verifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "gmb_verification_state",
  "account_id": "string",
  "location_id": "string",
  "summary": {
    "status": "string",
    "can_edit": true,
    "message": "string"
  },
  "voice_of_merchant_state": {},
  "verifications": [
    {}
  ]
}
```

## Start a Google Business verification

`POST /accounts/{accountId}/gmb-verifications`

Access: `write` · MCP tool: `start-gmb-verification` · Zernio: `POST /v1/accounts/{accountId}/gmb-verifications`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `method` (string; required; one of ADDRESS, EMAIL, PHONE_CALL, SMS, AUTO, TRUSTED_PARTNER, VETTED_PARTNER)
- `language_code` (string; ≤ 35 characters)
- `phone_number` (string; ≤ 40 characters)
- `email_address` (string; ≤ 320 characters)
- `mailer_contact` (object)
- `context` (object)
- `trusted_partner_token` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-verifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "method": "ADDRESS",
    "language_code": "string",
    "phone_number": "+15551234567",
    "email_address": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_verification",
  "account_id": "string",
  "location_id": "string",
  "verification": {}
}
```

## Fetch Google Business verification options

`POST /accounts/{accountId}/gmb-verifications/options`

Access: `write` · MCP tool: `fetch-gmb-verification-options` · Zernio: `POST /v1/accounts/{accountId}/gmb-verifications/options`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `language_code` (string; required; 2–35 characters)
- `context` (object)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-verifications/options" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "language_code": "string",
    "context": {}
  }'
```

Response 200:

```json
{
  "object": "gmb_verification_options",
  "account_id": "string",
  "location_id": "string",
  "options": [
    {}
  ]
}
```

## Complete a Google Business verification

`POST /accounts/{accountId}/gmb-verifications/{verificationId}/complete`

Access: `write` · MCP tool: `complete-gmb-verification` · Zernio: `POST /v1/accounts/{accountId}/gmb-verifications/{verificationId}/complete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `verificationId` (string; required; 1–512 characters)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `location_id` (string; 1–300 characters): Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id
- `pin` (string; required; 1–20 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-verifications/VERIFICATION_ID/complete" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "string",
    "pin": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_verification",
  "account_id": "string",
  "location_id": "string",
  "verification": {}
}
```

## List Google Business locations of the login

`GET /accounts/{accountId}/gmb-locations`

Every location the connected Google login manages (location picker), with the Socialit account already connected to each.

Access: `read` · MCP tool: `list-gmb-locations` · Zernio: `GET /v1/accounts/{accountId}/gmb-locations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `search` (string; ≤ 200 characters)
- `filter` (string; ≤ 500 characters)
- `limit` (integer; 1–500)
- `google_account_id` (string; ≤ 300 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "selected_location_id": "string",
  "data": [
    {
      "object": "gmb_location",
      "id": "string",
      "location_id": "string",
      "external_id": "string",
      "name": "string",
      "title": "string",
      "google_account_id": "string",
      "google_account_name": "string",
      "google_account_type": "string",
      "address": "string",
      "category": "string",
      "store_code": "string",
      "phone": "+15551234567",
      "website_uri": "string",
      "open_status": "string",
      "labels": [
        "string"
      ],
      "place_id": "string",
      "maps_uri": "string",
      "review_url": "https://example.com",
      "is_verified": true,
      "has_pending_edits": true,
      "has_google_updated": true,
      "can_have_food_menus": true,
      "can_operate_lodging_data": true,
      "can_operate_local_post": true,
      "can_modify_service_list": true,
      "duplicate_location": "string",
      "connected_account_id": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Switch the Google Business location

`PATCH /accounts/{accountId}/gmb-locations`

Point this account at another location of the same Google login. Emits account.updated.

Access: `write` · MCP tool: `select-gmb-location` · Zernio: `PUT /v1/accounts/{accountId}/gmb-locations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `selected_location_id` (string; required; 1–300 characters)
- `google_account_id` (string; ≤ 300 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "selected_location_id": "string",
    "google_account_id": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_location_selection",
  "account_id": "string",
  "message": "string",
  "selected_location": {
    "object": "gmb_location",
    "id": "string",
    "location_id": "string",
    "external_id": "string",
    "name": "string",
    "title": "string",
    "google_account_id": "string",
    "google_account_name": "string",
    "google_account_type": "string",
    "address": "string",
    "category": "string",
    "store_code": "string",
    "phone": "+15551234567",
    "website_uri": "string",
    "open_status": "string",
    "labels": [
      "string"
    ],
    "place_id": "string",
    "maps_uri": "string",
    "review_url": "https://example.com",
    "is_verified": true,
    "has_pending_edits": true,
    "has_google_updated": true,
    "can_have_food_menus": true,
    "can_operate_lodging_data": true,
    "can_operate_local_post": true,
    "can_modify_service_list": true,
    "duplicate_location": "string",
    "connected_account_id": "string"
  }
}
```

## Assign a Google Business location to a profile

`POST /accounts/{accountId}/gmb-locations/assign`

Connect another location of the same Google login as a new account in profile_id (201), or move it there when it is already connected in this workspace (200). Counts toward the plan account allowance. Emits account.connected / account.updated.

Access: `write` · MCP tool: `assign-gmb-location` · Zernio: `POST /v1/accounts/{accountId}/gmb-locations/assign`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `profile_id` (string; required; 1–80 characters)
- `selected_location_id` (string; required; 1–300 characters)
- `google_account_id` (string; ≤ 300 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-locations/assign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "string",
    "selected_location_id": "string",
    "google_account_id": "string"
  }'
```

Response 200:

```json
{
  "object": "gmb_location_assignment",
  "message": "string",
  "profile_id": "string",
  "selected_location_id": "string",
  "account": {
    "object": "account",
    "id": "string",
    "platform": "string",
    "connect_flow": "string",
    "account_type": "string",
    "profile_id": "string",
    "group_ids": [
      "string"
    ],
    "external_id": "string",
    "parent_external_id": "string",
    "username": "string",
    "name": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_url": "https://example.com",
    "status": "string",
    "is_active": true,
    "needs_reconnect": true,
    "scopes": [
      "string"
    ],
    "token_expires_at": "2026-10-13T09:00:00.000Z",
    "default_config": {},
    "metadata": {},
    "followers_count": 1,
    "followers_updated_at": "2026-10-13T09:00:00.000Z",
    "created_at": "2026-10-13T09:00:00.000Z",
    "updated_at": "2026-10-13T09:00:00.000Z"
  }
}
```

## List Facebook Pages of the connection

`GET /accounts/{accountId}/facebook-page`

Pages the connecting Facebook user granted, with the selected one and per-Page capabilities.

Access: `read` · MCP tool: `list-facebook-pages` · Zernio: `GET /v1/accounts/{accountId}/facebook-page`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `refresh` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook-page" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "selected_page_id": "string",
  "truncated": true,
  "data": [
    {
      "object": "facebook_page",
      "id": "string",
      "name": "string",
      "username": "string",
      "category": "string",
      "picture": "string",
      "tasks": [
        "string"
      ],
      "can_publish": true,
      "can_message": true,
      "can_analyze": true
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Switch the Facebook Page

`PATCH /accounts/{accountId}/facebook-page`

Point this account at another Page the user manages (stores the Page token). Emits account.updated.

Access: `write` · MCP tool: `select-facebook-page` · Zernio: `PUT /v1/accounts/{accountId}/facebook-page`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `selected_page_id` (string; required; 1–64 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook-page" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "selected_page_id": "string"
  }'
```

Response 200:

```json
{
  "object": "facebook_page_selection",
  "account_id": "string",
  "message": "string",
  "previous_page_id": "string",
  "selected_page": {
    "id": "string",
    "name": "string"
  }
}
```

## Read the Facebook Page's webhook subscription

`GET /accounts/{accountId}/webhook-subscription`

Whether Socialit is subscribed to the Page (real-time comments, messages, leads) and which fields are missing.

Access: `read` · MCP tool: `get-facebook-webhook-subscription` · Zernio: `GET /v1/accounts/{accountId}/webhook-subscription`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/webhook-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "facebook_webhook_subscription",
  "account_id": "string",
  "page_id": "string",
  "app_subscribed": true,
  "subscribed_fields": [
    "string"
  ],
  "missing_fields": [
    "string"
  ],
  "leadgen": true,
  "apps": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "warning": "string",
  "resubscribed": true
}
```

## Re-subscribe the Facebook Page to Socialit webhooks

`POST /accounts/{accountId}/webhook-subscription`

Access: `write` · MCP tool: `resubscribe-facebook-webhooks` · Zernio: `POST /v1/accounts/{accountId}/webhook-subscription`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `fields` (array of string; ≤ 50 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/webhook-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "facebook_webhook_subscription",
  "account_id": "string",
  "page_id": "string",
  "app_subscribed": true,
  "subscribed_fields": [
    "string"
  ],
  "missing_fields": [
    "string"
  ],
  "leadgen": true,
  "apps": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "warning": "string",
  "resubscribed": true
}
```

## List partner businesses of the Page

`GET /accounts/{accountId}/business-partners`

Access: `read` · MCP tool: `list-facebook-business-partners` · Zernio: `GET /v1/accounts/{accountId}/business-partners`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/business-partners" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "page": {
    "id": "string",
    "name": "string",
    "business": {
      "id": "string",
      "name": "string"
    }
  },
  "data": [
    {
      "object": "facebook_business_partner",
      "id": "string",
      "name": "string",
      "permitted_tasks": [
        "string"
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Share the Page with a partner business

`POST /accounts/{accountId}/business-partners`

Grant a partner Business Manager tasks on the Page (default ADVERTISE + ANALYZE).

Access: `write` · MCP tool: `share-facebook-page-with-partner` · Zernio: `POST /v1/accounts/{accountId}/business-partners`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `business_id` (string; required; pattern ^[0-9]{1,32}$)
- `permitted_tasks` (array of string; 1–40 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/business-partners" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "string",
    "permitted_tasks": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "facebook_business_partner_share",
  "account_id": "string",
  "page": {
    "id": "string",
    "name": "string",
    "business": {
      "id": "string",
      "name": "string"
    }
  },
  "partner": {
    "id": "string",
    "permitted_tasks": [
      "string"
    ]
  },
  "already_shared": true
}
```

## Revoke a partner business from the Page

`DELETE /accounts/{accountId}/business-partners`

Access: `write` · MCP tool: `revoke-facebook-business-partner` · Zernio: `DELETE /v1/accounts/{accountId}/business-partners`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `business_id` (string; required; pattern ^[0-9]{1,32}$)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/business-partners?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "facebook_business_partner",
  "id": "string",
  "page_id": "string",
  "deleted": true
}
```

## List LinkedIn organizations

`GET /accounts/{accountId}/linkedin-organizations`

Organizations (Pages) the member has a role on, with posting/admin rights.

Access: `read` · MCP tool: `list-linkedin-organizations` · Zernio: `GET /v1/accounts/{accountId}/linkedin-organizations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin-organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "data": [
    {
      "object": "linkedin_organization",
      "id": "string",
      "urn": "string",
      "name": "string",
      "localized_name": "string",
      "vanity_name": "string",
      "logo_url": "https://example.com",
      "roles": [
        "string"
      ],
      "can_post": true,
      "is_admin": true
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Switch LinkedIn account type

`PATCH /accounts/{accountId}/linkedin-organization`

Post as the personal profile or as an organization the member administers. Emits account.updated.

Access: `write` · MCP tool: `switch-linkedin-account-type` · Zernio: `PUT /v1/accounts/{accountId}/linkedin-organization`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `account_type` (string; required; one of personal, organization)
- `selected_organization` (string | object)
  - one of: Option 1 (string)
  - one of: Option 2 (object)
    - `selected_organization.id` (string | integer)
    - `selected_organization.urn` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin-organization" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_type": "personal",
    "selected_organization": "string"
  }'
```

Response 200:

```json
{
  "object": "linkedin_account_type",
  "account_id": "string",
  "account_type": "string",
  "account_name": "string",
  "message": "string"
}
```

## Resolve a LinkedIn mention

`GET /accounts/{accountId}/linkedin-mentions`

Turn a linkedin.com profile/company URL (or URN) into a mention (@[Name](urn)) for post content.

Access: `read` · MCP tool: `resolve-linkedin-mention` · Zernio: `GET /v1/accounts/{accountId}/linkedin-mentions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `url` (string; required; 3–2000 characters)
- `display_name` (string; ≤ 200 characters)
- `organization_urn` (string; ≤ 200 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin-mentions?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "linkedin_mention",
  "urn": "string",
  "type": "string",
  "display_name": "string",
  "mention_format": "string",
  "vanity_name": "string",
  "warning": "string"
}
```

## List active Instagram stories

`GET /accounts/{accountId}/instagram/stories`

Access: `read` · MCP tool: `list-instagram-stories` · Zernio: `GET /v1/accounts/{accountId}/instagram/stories`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string; ≤ 2048 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "data": [
    {
      "object": "instagram_story",
      "id": "string",
      "media_type": "string",
      "media_product_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "string",
      "timestamp": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Get Instagram story insights

`GET /accounts/{accountId}/instagram/stories/{storyId}/insights`

Metrics of a live story (24 h). source: unavailable with reason when Instagram no longer serves them.

Access: `read` · MCP tool: `get-instagram-story-insights` · Zernio: `GET /v1/accounts/{accountId}/instagram/stories/{storyId}/insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `storyId` (string; required; 1–128 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/stories/STORY_ID/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "instagram_story_insights",
  "story_id": "string",
  "source": "string",
  "reason": "string",
  "views": 1,
  "reach": 1,
  "replies": 1,
  "shares": 1,
  "profile_visits": 1,
  "follows": 1,
  "total_interactions": 1,
  "navigation": 1,
  "taps_forward": 1,
  "taps_back": 1,
  "exits": 1,
  "swipes_forward": 1
}
```

## Get Instagram publishing limit

`GET /accounts/{accountId}/instagram/publishing-limit`

Rolling 24 h content publishing quota (usage, total, remaining).

Access: `read` · MCP tool: `get-instagram-publishing-limit` · Zernio: `GET /v1/accounts/{accountId}/instagram/publishing-limit`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/publishing-limit" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "instagram_publishing_limit",
  "account_id": "string",
  "quota_usage": 1,
  "quota_total": 1,
  "quota_duration_seconds": 1,
  "remaining": 1
}
```

## Search Instagram audio

`GET /accounts/{accountId}/instagram/audio`

Reels audio search (trending when q is omitted). Needs a Facebook-Login Instagram connection.

Access: `read` · MCP tool: `search-instagram-audio` · Zernio: `GET /v1/accounts/{accountId}/instagram/audio`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `audio_type` (string; one of music, original_sound)
- `q` (string; ≤ 200 characters)
- `limit` (integer; 1–100)
- `cursor` (string; ≤ 2048 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/audio" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "data": [
    {
      "object": "instagram_audio",
      "audio_id": "string",
      "title": "string",
      "duration_in_ms": 1,
      "audio_type": "string",
      "display_artist": "string",
      "ig_username": "string",
      "profile_picture_url": "https://example.com",
      "download_url": "https://example.com",
      "preview_url": "https://example.com",
      "cover_artwork_url": "https://example.com",
      "is_ads_eligible": true
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Get Instagram audio metadata

`GET /accounts/{accountId}/instagram/audio/{audioId}`

Re-validates a track and refreshes its preview URL (expires after ~1.5 days).

Access: `read` · MCP tool: `get-instagram-audio` · Zernio: `GET /v1/accounts/{accountId}/instagram/audio/{audioId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `audioId` (string; required; 1–128 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/audio/AUDIO_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "instagram_audio",
  "audio_id": "string",
  "title": "string",
  "duration_in_ms": 1,
  "audio_type": "string",
  "display_artist": "string",
  "ig_username": "string",
  "profile_picture_url": "https://example.com",
  "download_url": "https://example.com",
  "preview_url": "https://example.com",
  "cover_artwork_url": "https://example.com",
  "is_ads_eligible": true
}
```

## Look up a public Instagram Business account

`GET /accounts/{accountId}/instagram/business-discovery`

Public profile and recent media of another Business/Creator account (competitor research).

Access: `read` · MCP tool: `instagram-business-discovery` · Zernio: `GET /v1/accounts/{accountId}/instagram/business-discovery`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `username` (string; required; pattern ^@?[A-Za-z0-9._]{1,30}$)
- `limit` (integer; 1–50)
- `cursor` (string; ≤ 2048 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/business-discovery?username=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "instagram_business_discovery",
  "profile": {
    "id": "string",
    "ig_id": 1,
    "username": "string",
    "name": "string",
    "biography": "string",
    "website": "https://example.com",
    "profile_picture_url": "https://example.com",
    "followers_count": 1,
    "follows_count": 1,
    "media_count": 1
  },
  "media": [
    {}
  ],
  "next_cursor": "string"
}
```

## Check whether an Instagram user follows the account

`GET /accounts/{accountId}/follow-status/{userId}`

Follow relationship for an Instagram-scoped user id (IGSID). Meta only answers for users who messaged the account; otherwise unavailable_reason is set.

Access: `read` · MCP tool: `get-instagram-follow-status` · Zernio: `GET /v1/accounts/{accountId}/follow-status/{userId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `userId` (string; required; 1–128 characters)

### Query parameters

- `refresh` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/follow-status/USER_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "instagram_follow_status",
  "account_id": "string",
  "user_id": "string",
  "is_follower": true,
  "is_followed_by_account": true,
  "follower_count": 1,
  "is_verified": true,
  "username": "string",
  "name": "string",
  "unavailable_reason": "string"
}
```

## List Pinterest boards

`GET /accounts/{accountId}/pinterest-boards`

Every board of the Pinterest account plus the stored default board.

Access: `read` · MCP tool: `list-pinterest-boards` · Zernio: `GET /v1/accounts/{accountId}/pinterest-boards`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest-boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "default_board_id": "string",
  "default_board_name": "string",
  "data": [
    {
      "object": "pinterest_board",
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string",
      "url": "https://example.com",
      "pin_count": 1,
      "follower_count": 1,
      "collaborator_count": 1,
      "is_ads_only": true,
      "image_cover_url": "https://example.com",
      "owner_username": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "board_pins_modified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Create a Pinterest board

`POST /accounts/{accountId}/pinterest-boards`

SECRET boards need the boards:write_secret scope.

Access: `write` · MCP tool: `create-pinterest-board` · Zernio: `POST /v1/accounts/{accountId}/pinterest-boards`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required; 1–180 characters)
- `description` (string; ≤ 500 characters)
- `privacy` (string; one of PUBLIC, PROTECTED, SECRET)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest-boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "privacy": "PUBLIC"
  }'
```

Response 201:

```json
{
  "object": "pinterest_board",
  "id": "string",
  "name": "string",
  "description": "string",
  "privacy": "string",
  "url": "https://example.com",
  "pin_count": 1,
  "follower_count": 1,
  "collaborator_count": 1,
  "is_ads_only": true,
  "image_cover_url": "https://example.com",
  "owner_username": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "board_pins_modified_at": "2026-10-13T09:00:00.000Z"
}
```

## Set the default Pinterest board

`PATCH /accounts/{accountId}/pinterest-boards`

Used when a post does not name a board. Emits account.updated.

Access: `write` · MCP tool: `set-default-pinterest-board` · Zernio: `PUT /v1/accounts/{accountId}/pinterest-boards`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `default_board_id` (string; required; 1–64 characters)
- `default_board_name` (string; ≤ 180 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest-boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_board_id": "string",
    "default_board_name": "string"
  }'
```

Response 200:

```json
{
  "object": "pinterest_default_board",
  "account_id": "string",
  "default_board_id": "string",
  "default_board_name": "string",
  "message": "string"
}
```

## List YouTube playlists

`GET /accounts/{accountId}/youtube-playlists`

Every playlist of the channel plus the stored default playlist.

Access: `read` · MCP tool: `list-youtube-playlists` · Zernio: `GET /v1/accounts/{accountId}/youtube-playlists`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube-playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "default_playlist_id": "string",
  "default_playlist_name": "string",
  "data": [
    {
      "object": "youtube_playlist",
      "id": "string",
      "title": "string",
      "description": "string",
      "privacy": "string",
      "item_count": 1,
      "thumbnail_url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Create a YouTube playlist

`POST /accounts/{accountId}/youtube-playlists`

Costs 50 quota units; not idempotent upstream (list before retrying).

Access: `write` · MCP tool: `create-youtube-playlist` · Zernio: `POST /v1/accounts/{accountId}/youtube-playlists`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `title` (string; required; 1–150 characters)
- `description` (string; ≤ 5000 characters)
- `privacy` (string; one of private, public, unlisted)
- `default_language` (string; ≤ 35 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube-playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "privacy": "private",
    "default_language": "string"
  }'
```

Response 201:

```json
{
  "object": "youtube_playlist",
  "id": "string",
  "title": "string",
  "description": "string",
  "privacy": "string",
  "item_count": 1,
  "thumbnail_url": "https://example.com",
  "published_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## Set the default YouTube playlist

`PATCH /accounts/{accountId}/youtube-playlists`

Pre-fills the composer playlist. Emits account.updated.

Access: `write` · MCP tool: `set-default-youtube-playlist` · Zernio: `PUT /v1/accounts/{accountId}/youtube-playlists`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `default_playlist_id` (string; required; 1–64 characters)
- `default_playlist_name` (string; ≤ 150 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube-playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_playlist_id": "string",
    "default_playlist_name": "string"
  }'
```

Response 200:

```json
{
  "object": "youtube_default_playlist",
  "account_id": "string",
  "default_playlist_id": "string",
  "default_playlist_name": "string"
}
```

## Get a YouTube video transcript

`GET /accounts/{accountId}/youtube-captions`

Caption track of a video on the channel as text + timed cues (optionally SRT/VTT, or translated with tlang).

Access: `read` · MCP tool: `get-youtube-transcript` · Zernio: `GET /v1/accounts/{accountId}/youtube-captions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `video_id` (string; required; 1–64 characters)
- `language` (string; ≤ 35 characters)
- `format` (string; one of json, srt, vtt)
- `track_id` (string; ≤ 200 characters)
- `tlang` (string; ≤ 35 characters)
- `refresh` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube-captions?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "youtube_transcript",
  "account_id": "string",
  "video_id": "string",
  "language": "en",
  "track_id": "string",
  "track_kind": "string",
  "source": "string",
  "fetched_at": "2026-10-13T09:00:00.000Z",
  "text": "string",
  "cues": [
    {
      "start": 1.5,
      "end": 1.5,
      "text": "string"
    }
  ],
  "srt": "string",
  "vtt": "string",
  "available_tracks": [
    {}
  ]
}
```

## List Reddit subreddits

`GET /accounts/{accountId}/reddit-subreddits`

Subreddits the user can post to (subscriber/contributor/moderator, plus the user profile) and the default subreddit.

Access: `read` · MCP tool: `list-reddit-subreddits` · Zernio: `GET /v1/accounts/{accountId}/reddit-subreddits`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `where` (string; one of postable, subscriber, moderator, contributor)
- `limit` (integer; 1–100)
- `cursor` (string; ≤ 200 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-subreddits" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "default_subreddit": "string",
  "data": [
    {
      "object": "reddit_subreddit",
      "id": "string",
      "name": "string",
      "prefixed_name": "string",
      "title": "string",
      "description": "string",
      "subscribers": 1,
      "active_users": 1,
      "type": "string",
      "over_18": true,
      "quarantined": true,
      "submission_type": "string",
      "post_types": {},
      "user_is_moderator": true,
      "user_is_contributor": true,
      "user_is_subscriber": true
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Set the default subreddit

`PATCH /accounts/{accountId}/reddit-subreddits`

Validates the subreddit exists. Emits account.updated.

Access: `write` · MCP tool: `set-default-reddit-subreddit` · Zernio: `PUT /v1/accounts/{accountId}/reddit-subreddits`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `default_subreddit` (string; required; 1–64 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-subreddits" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_subreddit": "string"
  }'
```

Response 200:

```json
{
  "object": "reddit_default_subreddit",
  "account_id": "string",
  "default_subreddit": "string"
}
```

## Get subreddit rules

`GET /accounts/{accountId}/reddit-subreddits/{subreddit}/rules`

Access: `read` · MCP tool: `get-reddit-subreddit-rules` · Zernio: `GET /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `subreddit` (string; required; 1–64 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-subreddits/SUBREDDIT/rules" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "reddit_subreddit_rules",
  "subreddit": "string",
  "rules": [
    {
      "id": "string",
      "priority": 1,
      "short_name": "string",
      "description": "string",
      "violation_reason": "string",
      "kind": "string",
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "site_rules": [
    "string"
  ],
  "site_rules_flow": [
    {}
  ]
}
```

## List subreddit post flairs

`GET /accounts/{accountId}/reddit-flairs`

restricted: true when the user cannot set link flair in that subreddit.

Access: `read` · MCP tool: `list-reddit-flairs` · Zernio: `GET /v1/accounts/{accountId}/reddit-flairs`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `subreddit` (string; required; 1–64 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-flairs?subreddit=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "subreddit": "string",
  "restricted": true,
  "data": [
    {
      "object": "reddit_flair",
      "id": "string",
      "text": "string",
      "text_color": "string",
      "background_color": "string",
      "text_editable": true,
      "type": "string",
      "richtext": [
        null
      ],
      "mod_only": true,
      "allowable_content": "string",
      "max_emojis": 1,
      "css_class": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Set a Reddit post flair

`POST /accounts/{accountId}/reddit-flairs`

Access: `write` · MCP tool: `set-reddit-post-flair` · Zernio: `POST /v1/accounts/{accountId}/reddit-flairs`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `subreddit` (string; 1–64 characters)
- `post_id` (string; required; 1–32 characters)
- `flair_template_id` (string; required; 1–64 characters)
- `text` (string; ≤ 64 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-flairs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "post_id": "string",
    "flair_template_id": "string",
    "text": "string"
  }'
```

Response 200:

```json
{
  "object": "reddit_post_flair",
  "account_id": "string",
  "post_id": "string",
  "flair_template_id": "string",
  "text": "string",
  "success": true
}
```

## Vote on a Reddit post or comment

`POST /accounts/{accountId}/reddit-vote`

One vote per call, triggered by an explicit human action (automated or bulk voting violates Reddit rules).

Access: `write` · MCP tool: `vote-on-reddit` · Zernio: `POST /v1/accounts/{accountId}/reddit-vote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `thing_id` (string; required; 2–32 characters)
- `direction` (integer; required; one of 1, 0, -1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "thing_id": "string",
    "direction": 1
  }'
```

Response 200:

```json
{
  "object": "reddit_vote",
  "account_id": "string",
  "thing_id": "string",
  "direction": 1,
  "success": true
}
```

## Get TikTok creator info

`GET /accounts/{accountId}/tiktok/creator-info`

Latest creator_info for the Post-to-TikTok UX: privacy options, interaction locks, max duration, whether the creator can post now.

Access: `read` · MCP tool: `get-tiktok-creator-info` · Zernio: `GET /v1/accounts/{accountId}/tiktok/creator-info`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `media_type` (string; one of video, photo)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/creator-info" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "tiktok_creator_info",
  "account_id": "string",
  "lane": "string",
  "creator": {
    "nickname": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "is_verified": true,
    "can_post_more": true,
    "reason": "string"
  },
  "privacy_levels": [
    {
      "value": "string",
      "label": "string"
    }
  ],
  "posting_limits": {
    "max_video_duration_sec": 1,
    "interaction_settings": {
      "allow_comment": {
        "enabled": true,
        "required": true,
        "default": true,
        "label": "string"
      },
      "allow_duet": {
        "enabled": true,
        "required": true,
        "default": true,
        "label": "string"
      },
      "allow_stitch": {
        "enabled": true,
        "required": true,
        "default": true,
        "label": "string"
      }
    }
  },
  "commercial_content_types": [
    {
      "value": "string",
      "label": "string",
      "requires": "string"
    }
  ],
  "warning": "string"
}
```

## Get TikTok composer requirements

`GET /accounts/{accountId}/tiktok/composer`

Everything a "Post to TikTok" UI must render under the Content Sharing Guidelines, from live creator_info: creator nickname/avatar, privacy options (no default), interaction toggles (off by default, locked when the creator disabled them), commercial content disclosure, the exact declaration text, notices and limits. Re-fetch on every composer render.

Access: `read` · MCP tool: `get-tiktok-composer-requirements`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `media_type` (string; one of video, photo)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/composer" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "tiktok_composer_requirements",
  "account_id": "string",
  "lane": "string",
  "media_type": "string",
  "fetched_at": "2026-10-13T09:00:00.000Z",
  "creator": {
    "nickname": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "avatar_ttl_seconds": 1,
    "must_display": [
      "string"
    ],
    "can_post": true,
    "cannot_post_reason": "string",
    "cannot_post_message": "string",
    "warning": "string"
  },
  "privacy": {
    "options": [
      {
        "value": "string",
        "label": "string",
        "allowed_with_branded_content": true
      }
    ],
    "default": "string",
    "required": true,
    "control": "string",
    "direct_post_forced": "string"
  },
  "interactions": {
    "comment": {
      "label": "string",
      "available": true,
      "disabled_by_creator": true,
      "default": true,
      "required_user_action": true
    },
    "duet": {
      "label": "string",
      "available": true,
      "disabled_by_creator": true,
      "default": true,
      "required_user_action": true
    },
    "stitch": {
      "label": "string",
      "available": true,
      "disabled_by_creator": true,
      "default": true,
      "required_user_action": true
    }
  },
  "max_video_duration_sec": 1,
  "commercial_content": {
    "toggle": {
      "label": "string",
      "default": true
    },
    "options": [
      {
        "value": "string",
        "label": "string",
        "maps_to": "+15551234567",
        "notice": "string",
        "default": true,
        "disallowed_privacy": [
          "string"
        ]
      }
    ],
    "multi_select": true,
    "both_selected_notice": "string",
    "selection_required_when_on": true,
    "publish_disabled_tooltip": "string"
  },
  "declaration": {
    "position": "string",
    "default": "string",
    "your_brand_only": "string",
    "branded_content": "string",
    "links": {
      "musicUsageConfirmation": "string",
      "brandedContentPolicy": "string"
    }
  },
  "notices": {
    "processing": "string",
    "draft": "string"
  },
  "rules": {
    "key": true
  },
  "limits": {
    "title_max": 1,
    "description_max": 1,
    "photos_max": 1,
    "formats": [
      "string"
    ],
    "max_bytes": 1,
    "posts_per_day": 1,
    "pending_drafts": 1
  },
  "features": {
    "key": true
  }
}
```

## List trending TikTok commercial music

`GET /accounts/{accountId}/tiktok/commercial-music`

Commercial Music Library tracks (TikTok Business connections).

Access: `read` · MCP tool: `list-tiktok-commercial-music` · Zernio: `GET /v1/accounts/{accountId}/tiktok/commercial-music`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `country_code` (string; pattern ^[A-Za-z]{2}$)
- `genre` (string; ≤ 64 characters)
- `date_range` (string; one of 1DAY, 7DAY, 30DAY, 90DAY)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/commercial-music" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "data": [
    {
      "object": "tiktok_music_track",
      "id": "string",
      "commercial_music_id": "string",
      "name": "string",
      "artist": "string",
      "duration_sec": 1.5,
      "genres": [
        "string"
      ],
      "preview_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "rank": 1,
      "trending_history": [
        {}
      ],
      "clip": {
        "id": "string",
        "duration_sec": 1.5,
        "preview_url": "https://example.com"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Search TikTok location tags

`GET /accounts/{accountId}/tiktok/locations`

Up to 20 location tags for posts (TikTok Business connections).

Access: `read` · MCP tool: `search-tiktok-locations` · Zernio: `GET /v1/accounts/{accountId}/tiktok/locations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `query` (string; required; 1–100 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/locations?query=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "data": [
    {
      "object": "tiktok_location",
      "id": "string",
      "name": "string",
      "address": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Get Bluesky account settings

`GET /accounts/{accountId}/bluesky-settings`

Posting defaults applied to every new Bluesky post (languages, reply/quote controls, labels, tags, auto facets/link cards).

Access: `read` · MCP tool: `get-bluesky-settings` · Zernio: `GET /v1/accounts/{accountId}/bluesky-settings`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "bluesky_settings",
  "account_id": "string",
  "default_langs": [
    "string"
  ],
  "default_threadgate": [
    "string"
  ],
  "default_postgate": {
    "disable_quotes": true
  },
  "default_labels": [
    "string"
  ],
  "default_tags": [
    "string"
  ],
  "auto_facets": true,
  "auto_link_cards": true
}
```

## Update Bluesky account settings

`PATCH /accounts/{accountId}/bluesky-settings`

Partial update; only affects posts published afterwards. Emits account.updated.

Access: `write` · MCP tool: `update-bluesky-settings` · Zernio: `PATCH /v1/accounts/{accountId}/bluesky-settings`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `default_langs` (array of string | null; ≤ 3 items)
- `default_threadgate` (array of string | null; ≤ 5 items)
- `default_postgate` (object | null)
  - `default_postgate.disable_quotes` (boolean)
- `default_labels` (array of string; ≤ 4 items)
- `default_tags` (array of string; ≤ 8 items)
- `auto_facets` (boolean)
- `auto_link_cards` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_langs": [
      "string"
    ],
    "default_threadgate": [
      "string"
    ],
    "default_postgate": {
      "disable_quotes": true
    },
    "default_labels": [
      "sexual"
    ],
    "default_tags": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "bluesky_settings",
  "account_id": "string",
  "default_langs": [
    "string"
  ],
  "default_threadgate": [
    "string"
  ],
  "default_postgate": {
    "disable_quotes": true
  },
  "default_labels": [
    "string"
  ],
  "default_tags": [
    "string"
  ],
  "auto_facets": true,
  "auto_link_cards": true
}
```

## Get Discord account settings

`GET /accounts/{accountId}/discord-settings`

Access: `read` · MCP tool: `get-discord-settings` · Zernio: `GET /v1/accounts/{accountId}/discord-settings`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_settings",
  "account_id": "string",
  "mode": "string",
  "guild_id": "string",
  "guild_name": "string",
  "channel_id": "string",
  "channel_name": "string",
  "channel_type": 1,
  "webhook_username": "string",
  "webhook_avatar_url": "https://example.com"
}
```

## Update Discord account settings

`PATCH /accounts/{accountId}/discord-settings`

Webhook identity (username / avatar; empty clears) or, for bot connections, the posting channel in the same server. Emits account.updated.

Access: `write` · MCP tool: `update-discord-settings` · Zernio: `PATCH /v1/accounts/{accountId}/discord-settings`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `webhook_username` (string | null; ≤ 80 characters)
- `webhook_avatar_url` (string | null; ≤ 2048 characters)
- `channel_id` (string; pattern ^[0-9]{5,25}$)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_username": "string",
    "webhook_avatar_url": "https://example.com",
    "channel_id": "string"
  }'
```

Response 200:

```json
{
  "object": "discord_settings",
  "account_id": "string",
  "mode": "string",
  "guild_id": "string",
  "guild_name": "string",
  "channel_id": "string",
  "channel_name": "string",
  "channel_type": 1,
  "webhook_username": "string",
  "webhook_avatar_url": "https://example.com"
}
```

## List Discord server channels

`GET /accounts/{accountId}/discord-channels`

Access: `read` · MCP tool: `list-discord-channels` · Zernio: `GET /v1/accounts/{accountId}/discord-channels`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `types` (string; pattern ^[0-9]+(,[0-9]+)*$)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord-channels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "data": [
    {
      "object": "discord_channel",
      "id": "string",
      "name": "string",
      "type": 1,
      "type_name": "string",
      "parent_id": "string",
      "position": 1,
      "topic": "string",
      "nsfw": true,
      "postable": true
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Send a Discord direct message

`POST /discord/dms`

DM a server member from the Socialit bot. Runs on the Socialit Discord bot; account_id must be a bot-mode Discord account connected to that server.

Access: `write` · MCP tool: `send-discord-dm` · Zernio: `POST /v1/discord/dms`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `user_id` (string; required; pattern ^[0-9]{5,25}$)
- `content` (string; ≤ 2000 characters)
- `embeds` (array of object; ≤ 10 items)
- `attachments` (array of object; ≤ 10 items)
  - `attachments[].type` (string; required; one of image, video, gif, document)
  - `attachments[].url` (string; required; ≤ 4096 characters, pattern ^https?://)
  - `attachments[].filename` (string; ≤ 200 characters)
  - `attachments[].mime_type` (string; ≤ 100 characters)
  - `attachments[].size` (integer)
- `tts` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/discord/dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "user_id": "string",
    "content": "string",
    "embeds": [
      {}
    ],
    "attachments": [
      {
        "type": "image",
        "url": "https://example.com"
      }
    ]
  }'
```

Response 200:

```json
{
  "object": "discord_dm",
  "account_id": "string",
  "message_id": "string",
  "channel_id": "string",
  "url": "https://example.com",
  "timestamp": "string",
  "recipient": {
    "user_id": "string",
    "platform": "string"
  }
}
```

## List Discord server roles

`GET /discord/guilds/{guildId}/roles`

Runs on the Socialit Discord bot; account_id must be a bot-mode Discord account connected to that server.

Access: `read` · MCP tool: `list-discord-roles` · Zernio: `GET /v1/discord/guilds/{guildId}/roles`

### Path parameters

- `guildId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/roles?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "guild_id": "string",
  "data": [
    {
      "object": "discord_role",
      "id": "string",
      "name": "string",
      "color": 1,
      "position": 1,
      "permissions": "string",
      "permission_names": [
        "string"
      ],
      "managed": true,
      "mentionable": true,
      "hoist": true,
      "icon": "string",
      "unicode_emoji": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Create a Discord server role

`POST /discord/guilds/{guildId}/roles`

Runs on the Socialit Discord bot; account_id must be a bot-mode Discord account connected to that server. Needs MANAGE_ROLES.

Access: `write` · MCP tool: `create-discord-role` · Zernio: `POST /v1/discord/guilds/{guildId}/roles`

### Path parameters

- `guildId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required; 1–100 characters)
- `color` (integer | string)
- `hoist` (boolean)
- `mentionable` (boolean)
- `permissions` (string | array of string)
- `unicode_emoji` (string | null; ≤ 32 characters)
- `reason` (string; ≤ 512 characters)

```bash
curl -X POST "https://api.socialit.com/v1/discord/guilds/GUILD_ID/roles?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "color": 0,
    "hoist": true,
    "mentionable": true,
    "permissions": "string"
  }'
```

Response 201:

```json
{
  "object": "discord_role",
  "id": "string",
  "name": "string",
  "color": 1,
  "position": 1,
  "permissions": "string",
  "permission_names": [
    "string"
  ],
  "managed": true,
  "mentionable": true,
  "hoist": true,
  "icon": "string",
  "unicode_emoji": "string"
}
```

## Edit a Discord server role

`PATCH /discord/guilds/{guildId}/roles/{roleId}`

Access: `write` · MCP tool: `update-discord-role` · Zernio: `PATCH /v1/discord/guilds/{guildId}/roles/{roleId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `roleId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `name` (string; 1–100 characters)
- `color` (integer | string)
- `hoist` (boolean)
- `mentionable` (boolean)
- `permissions` (string | array of string)
- `unicode_emoji` (string | null; ≤ 32 characters)
- `reason` (string; ≤ 512 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/discord/guilds/GUILD_ID/roles/ROLE_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "color": 0,
    "hoist": true,
    "mentionable": true,
    "permissions": "string"
  }'
```

Response 200:

```json
{
  "object": "discord_role",
  "id": "string",
  "name": "string",
  "color": 1,
  "position": 1,
  "permissions": "string",
  "permission_names": [
    "string"
  ],
  "managed": true,
  "mentionable": true,
  "hoist": true,
  "icon": "string",
  "unicode_emoji": "string"
}
```

## Delete a Discord server role

`DELETE /discord/guilds/{guildId}/roles/{roleId}`

Access: `write` · MCP tool: `delete-discord-role` · Zernio: `DELETE /v1/discord/guilds/{guildId}/roles/{roleId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `roleId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `reason` (string; ≤ 512 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/discord/guilds/GUILD_ID/roles/ROLE_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_role",
  "id": "string",
  "deleted": true
}
```

## List Discord server members

`GET /discord/guilds/{guildId}/members`

Needs the privileged GUILD_MEMBERS intent; otherwise an empty list with intent_missing: true. Page with after = next_cursor.

Access: `read` · MCP tool: `list-discord-members` · Zernio: `GET /v1/discord/guilds/{guildId}/members`

### Path parameters

- `guildId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `limit` (integer; 1–1000)
- `after` (string; pattern ^[0-9]{5,25}$)

```bash
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/members?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "guild_id": "string",
  "intent_missing": true,
  "data": [
    {
      "object": "discord_member",
      "id": "string",
      "username": "string",
      "global_name": "string",
      "nick": "string",
      "display_name": "string",
      "avatar": "string",
      "bot": true,
      "roles": [
        "string"
      ],
      "joined_at": "2026-10-13T09:00:00.000Z",
      "premium_since": "string",
      "pending": true,
      "communication_disabled_until": "string",
      "flags": 1
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Search Discord server members

`GET /discord/guilds/{guildId}/members/search`

Prefix match on username / nickname (no privileged intent needed).

Access: `read` · MCP tool: `search-discord-members` · Zernio: `GET /v1/discord/guilds/{guildId}/members/search`

### Path parameters

- `guildId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `query` (string; required; 1–100 characters)
- `limit` (integer; 1–1000)

```bash
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/members/search?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd&query=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "guild_id": "string",
  "intent_missing": true,
  "data": [
    {
      "object": "discord_member",
      "id": "string",
      "username": "string",
      "global_name": "string",
      "nick": "string",
      "display_name": "string",
      "avatar": "string",
      "bot": true,
      "roles": [
        "string"
      ],
      "joined_at": "2026-10-13T09:00:00.000Z",
      "premium_since": "string",
      "pending": true,
      "communication_disabled_until": "string",
      "flags": 1
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Get a Discord server member

`GET /discord/guilds/{guildId}/members/{userId}`

Access: `read` · MCP tool: `get-discord-member` · Zernio: `GET /v1/discord/guilds/{guildId}/members/{userId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `userId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/members/USER_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_member",
  "id": "string",
  "username": "string",
  "global_name": "string",
  "nick": "string",
  "display_name": "string",
  "avatar": "string",
  "bot": true,
  "roles": [
    "string"
  ],
  "joined_at": "2026-10-13T09:00:00.000Z",
  "premium_since": "string",
  "pending": true,
  "communication_disabled_until": "string",
  "flags": 1
}
```

## Assign a role to a Discord member

`PUT /discord/guilds/{guildId}/members/{userId}/roles/{roleId}`

Access: `write` · MCP tool: `add-discord-member-role` · Zernio: `PUT /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `userId` (string; required; 1–512 characters)
- `roleId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `reason` (string; ≤ 512 characters)

```bash
curl -X PUT "https://api.socialit.com/v1/discord/guilds/GUILD_ID/members/USER_ID/roles/ROLE_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_member_role",
  "guild_id": "string",
  "user_id": "string",
  "role_id": "string",
  "operation": "string"
}
```

## Remove a role from a Discord member

`DELETE /discord/guilds/{guildId}/members/{userId}/roles/{roleId}`

Access: `write` · MCP tool: `remove-discord-member-role` · Zernio: `DELETE /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `userId` (string; required; 1–512 characters)
- `roleId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `reason` (string; ≤ 512 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/discord/guilds/GUILD_ID/members/USER_ID/roles/ROLE_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_member_role",
  "guild_id": "string",
  "user_id": "string",
  "role_id": "string",
  "operation": "string"
}
```

## Delete a Discord channel message

`DELETE /discord/channels/{channelId}/messages/{messageId}`

Runs on the Socialit Discord bot; account_id must be a bot-mode Discord account connected to that server. Deleting other users' messages needs MANAGE_MESSAGES.

Access: `write` · MCP tool: `delete-discord-message` · Zernio: `DELETE /v1/discord/channels/{channelId}/messages/{messageId}`

### Path parameters

- `channelId` (string; required; 1–512 characters)
- `messageId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `reason` (string; ≤ 512 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/discord/channels/CHANNEL_ID/messages/MESSAGE_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_message",
  "id": "string",
  "channel_id": "string",
  "deleted": true
}
```

## Crosspost a Discord announcement

`POST /discord/channels/{channelId}/messages/{messageId}/crosspost`

Publish an announcement-channel message to every following server.

Access: `write` · MCP tool: `crosspost-discord-message` · Zernio: `POST /v1/discord/channels/{channelId}/messages/{messageId}/crosspost`

### Path parameters

- `channelId` (string; required; 1–512 characters)
- `messageId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/discord/channels/CHANNEL_ID/messages/MESSAGE_ID/crosspost?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

Response 200:

```json
{
  "object": "discord_crosspost",
  "id": "string",
  "channel_id": "string",
  "message": {}
}
```

## Create a Discord public thread

`POST /discord/channels/{channelId}/threads`

From a message when message_id is set, otherwise a standalone thread.

Access: `write` · MCP tool: `create-discord-thread` · Zernio: `POST /v1/discord/channels/{channelId}/threads`

### Path parameters

- `channelId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required; 1–100 characters)
- `message_id` (string; pattern ^[0-9]{5,25}$)
- `auto_archive_duration` (integer; one of 60, 1440, 4320, 10080)
- `rate_limit_per_user` (integer; 0–21600)
- `reason` (string; ≤ 512 characters)

```bash
curl -X POST "https://api.socialit.com/v1/discord/channels/CHANNEL_ID/threads?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "message_id": "string",
    "auto_archive_duration": 60,
    "rate_limit_per_user": 0,
    "reason": "string"
  }'
```

Response 201:

```json
{
  "object": "discord_thread",
  "id": "string",
  "name": "string",
  "parent_id": "string",
  "thread": {}
}
```

## List pinned Discord messages

`GET /discord/channels/{channelId}/pins`

Access: `read` · MCP tool: `list-discord-pins` · Zernio: `GET /v1/discord/channels/{channelId}/pins`

### Path parameters

- `channelId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `before` (string; ≤ 40 characters)
- `limit` (integer; 1–50)

```bash
curl "https://api.socialit.com/v1/discord/channels/CHANNEL_ID/pins?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "channel_id": "string",
  "data": [
    {
      "object": "discord_pinned_message",
      "id": "string",
      "channel_id": "string",
      "content": "string",
      "timestamp": "string",
      "pinned_at": "2026-10-13T09:00:00.000Z",
      "author": {},
      "attachments": [
        {}
      ],
      "embeds": [
        {}
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Pin a Discord message

`PUT /discord/channels/{channelId}/pins/{messageId}`

Access: `write` · MCP tool: `pin-discord-message` · Zernio: `PUT /v1/discord/channels/{channelId}/pins/{messageId}`

### Path parameters

- `channelId` (string; required; 1–512 characters)
- `messageId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `reason` (string; ≤ 512 characters)

```bash
curl -X PUT "https://api.socialit.com/v1/discord/channels/CHANNEL_ID/pins/MESSAGE_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_pin",
  "channel_id": "string",
  "message_id": "string",
  "pinned": true
}
```

## Unpin a Discord message

`DELETE /discord/channels/{channelId}/pins/{messageId}`

Access: `write` · MCP tool: `unpin-discord-message` · Zernio: `DELETE /v1/discord/channels/{channelId}/pins/{messageId}`

### Path parameters

- `channelId` (string; required; 1–512 characters)
- `messageId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `reason` (string; ≤ 512 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/discord/channels/CHANNEL_ID/pins/MESSAGE_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_pin",
  "channel_id": "string",
  "message_id": "string",
  "pinned": true
}
```

## List Discord scheduled events

`GET /discord/guilds/{guildId}/events`

Access: `read` · MCP tool: `list-discord-events` · Zernio: `GET /v1/discord/guilds/{guildId}/events`

### Path parameters

- `guildId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `with_user_count` (boolean)

```bash
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/events?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "account_id": "string",
  "guild_id": "string",
  "data": [
    {
      "object": "discord_scheduled_event",
      "id": "string",
      "guild_id": "string",
      "name": "string",
      "description": "string",
      "starts_at": "2026-10-13T09:00:00.000Z",
      "ends_at": "2026-10-13T09:00:00.000Z",
      "status": "string",
      "entity_type": "string",
      "channel_id": "string",
      "location": "string",
      "user_count": 1,
      "image": "string",
      "recurrence_rule": {},
      "creator_id": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```

## Create a Discord scheduled event

`POST /discord/guilds/{guildId}/events`

External (location + end time), voice or stage (channel) events; always server-only privacy.

Access: `write` · MCP tool: `create-discord-event` · Zernio: `POST /v1/discord/guilds/{guildId}/events`

### Path parameters

- `guildId` (string; required; 1–512 characters)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `name` (string; required; 1–100 characters)
- `description` (string; ≤ 1000 characters)
- `starts_at` (string; required; 10–40 characters)
- `ends_at` (string; 10–40 characters)
- `entity` (object; required)
  - `entity.type` (string; required; one of external, voice, stage)
  - `entity.location` (string; ≤ 100 characters)
  - `entity.channel_id` (string; pattern ^[0-9]{5,25}$)
  - `entity.ends_at` (string; 10–40 characters)
- `image_data_uri` (string | null; ≤ 12000000 characters): data: URI or https URL (null clears on update)
- `recurrence_rule` (object)
- `reason` (string; ≤ 512 characters)

```bash
curl -X POST "https://api.socialit.com/v1/discord/guilds/GUILD_ID/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "name": "string",
    "description": "string",
    "starts_at": "2026-10-13T09:00:00.000Z",
    "entity": {
      "type": "external",
      "location": "string"
    }
  }'
```

Response 201:

```json
{
  "object": "discord_scheduled_event",
  "id": "string",
  "guild_id": "string",
  "name": "string",
  "description": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "status": "string",
  "entity_type": "string",
  "channel_id": "string",
  "location": "string",
  "user_count": 1,
  "image": "string",
  "recurrence_rule": {},
  "creator_id": "string"
}
```

## Get a Discord scheduled event

`GET /discord/guilds/{guildId}/events/{eventId}`

Access: `read` · MCP tool: `get-discord-event` · Zernio: `GET /v1/discord/guilds/{guildId}/events/{eventId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `eventId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `with_user_count` (boolean)

```bash
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/events/EVENT_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_scheduled_event",
  "id": "string",
  "guild_id": "string",
  "name": "string",
  "description": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "status": "string",
  "entity_type": "string",
  "channel_id": "string",
  "location": "string",
  "user_count": 1,
  "image": "string",
  "recurrence_rule": {},
  "creator_id": "string"
}
```

## Update a Discord scheduled event

`PATCH /discord/guilds/{guildId}/events/{eventId}`

Access: `write` · MCP tool: `update-discord-event` · Zernio: `PATCH /v1/discord/guilds/{guildId}/events/{eventId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `eventId` (string; required; 1–512 characters)

### Body

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `name` (string; 1–100 characters)
- `description` (string | null; ≤ 1000 characters)
- `starts_at` (string; 10–40 characters)
- `ends_at` (string | null; ≤ 40 characters)
- `location` (string; ≤ 100 characters)
- `status` (string; one of scheduled, active, completed, cancelled)
- `image_data_uri` (string | null; ≤ 12000000 characters): data: URI or https URL (null clears on update)
- `recurrence_rule` (object | null)
- `reason` (string; ≤ 512 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/discord/guilds/GUILD_ID/events/EVENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "name": "string",
    "description": "string",
    "starts_at": "2026-10-13T09:00:00.000Z",
    "ends_at": "2026-10-13T09:00:00.000Z"
  }'
```

Response 200:

```json
{
  "object": "discord_scheduled_event",
  "id": "string",
  "guild_id": "string",
  "name": "string",
  "description": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "status": "string",
  "entity_type": "string",
  "channel_id": "string",
  "location": "string",
  "user_count": 1,
  "image": "string",
  "recurrence_rule": {},
  "creator_id": "string"
}
```

## Delete a Discord scheduled event

`DELETE /discord/guilds/{guildId}/events/{eventId}`

Access: `write` · MCP tool: `delete-discord-event` · Zernio: `DELETE /v1/discord/guilds/{guildId}/events/{eventId}`

### Path parameters

- `guildId` (string; required; 1–512 characters)
- `eventId` (string; required; 1–512 characters)

### Query parameters

- `account_id` (string; required; 1–80 characters): Social account id (sa_…)
- `reason` (string; ≤ 512 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/discord/guilds/GUILD_ID/events/EVENT_ID?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "discord_scheduled_event",
  "id": "string",
  "deleted": true
}
```


---

Source: https://socialit.com/docs/api-reference/platform-tools/
