Skip to content
Docs

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 URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits91 endpointsMCP toolset platform_tools

GBP reviews

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: readZernio: GET /v1/accounts/{accountId}/gmb-reviews

Try it with MCPAsk your agent to call list-gmb-reviews (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

limitintegerdefault: 50

1–50

cursorstring

≤ 2048 characters

order_bystring

update_time descupdateTime descratingrating desc

Returns object

objectstringrequired

list

account_idstring
location_idstring | null
average_ratingnumber | null
total_review_countinteger | null
dataarray of objectrequired
Show 22 item attributes
objectstring

gmb_review

idstring
namestring | null
location_idstring | null
ratinginteger | null
textstring | null
text_translatedstring | null
text_originalstring | null
authorstring | null
author_avatar_urlstring | null
author_is_anonymousboolean
created_atstring | null
updated_atstring | null
has_replyboolean
replystring | null
reply_updated_atstring | null
reply_statestring | null
reply_policy_violationobject | string | null
reply_urlstring | null
has_photosboolean
photo_countinteger
mediaarray of object
Show 3 item attributes
typestring
urlstring | null
thumbnail_urlstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-reviews
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: readZernio: POST /v1/accounts/{accountId}/gmb-reviews/batch

Try it with MCPAsk your agent to call batch-get-gmb-reviews (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

location_idsarray of stringrequired

1–50 items

google_account_idstring

≤ 300 characters

limitinteger

1–50

cursorstring

≤ 2048 characters

order_bystring

update_time descupdateTime descratingrating desc

ignore_rating_only_reviewsboolean

Returns object

objectstringrequired

list

account_idstring
google_account_idstring | null
dataarray of objectrequired
Show 3 item attributes
objectstring

gmb_location_review

location_idstring | null
reviewobject
Show 22 child attributes
objectstring

gmb_review

idstring
namestring | null
location_idstring | null
ratinginteger | null
textstring | null
text_translatedstring | null
text_originalstring | null
authorstring | null
author_avatar_urlstring | null
author_is_anonymousboolean
created_atstring | null
updated_atstring | null
has_replyboolean
replystring | null
reply_updated_atstring | null
reply_statestring | null
reply_policy_violationobject | string | null
reply_urlstring | null
has_photosboolean
photo_countinteger
mediaarray of object
Show 3 item attributes
typestring
urlstring | null
thumbnail_urlstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-reviews/batch
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

Get a Google Business review

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

Access: readZernio: GET /v1/accounts/{accountId}/gmb-reviews/{reviewId}

Try it with MCPAsk your agent to call get-gmb-review (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

reviewIdstringrequired

1–512 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_review

idstring
namestring | null
location_idstring | null
ratinginteger | null
textstring | null
text_translatedstring | null
text_originalstring | null
authorstring | null
author_avatar_urlstring | null
author_is_anonymousboolean
created_atstring | null
updated_atstring | null
has_replyboolean
replystring | null
reply_updated_atstring | null
reply_statestring | null
reply_policy_violationobject | string | null
reply_urlstring | null
has_photosboolean
photo_countinteger
mediaarray of object
Show 3 item attributes
typestring
urlstring | null
thumbnail_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-reviews/{reviewId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews/REVIEW_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply

Try it with MCPAsk your agent to call reply-to-gmb-review (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

reviewIdstringrequired

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

commentstringrequired

1–4096 characters

automatedbooleandefault: false

true when no human pressed send (AI agents, workflows, auto-responders); needs the location opt-in

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_review_reply

review_idstring
namestring | null
commentstring | null
updated_atstring | null
reply_statestring | null
automatedboolean
deletedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-reviews/{reviewId}/reply
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

Delete a Google Business review reply

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

Access: writeZernio: DELETE /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply

Try it with MCPAsk your agent to call delete-gmb-review-reply (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

reviewIdstringrequired

1–512 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_review_reply

review_idstring
namestring | null
commentstring | null
updated_atstring | null
reply_statestring | null
automatedboolean
deletedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/gmb-reviews/{reviewId}/reply
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-reviews/REVIEW_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

GBP automation

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

Try it with MCPAsk your agent to call get-gmb-automation (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_automation

idstring | null
account_idstring
location_idstring
automated_review_repliesboolean
automated_listing_editsboolean
consent_textstring | null
opted_in_byobject | null
Show 3 child attributes
typestring
idstring | null
namestring | null
opted_in_atstring | null
updated_atstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-automation
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-automation" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call update-gmb-automation (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

automated_review_repliesboolean
automated_listing_editsboolean
consent_textstring | null

≤ 2000 characters

Returns object

objectstring

gmb_automation

idstring | null
account_idstring
location_idstring
automated_review_repliesboolean
automated_listing_editsboolean
consent_textstring | null
opted_in_byobject | null
Show 3 child attributes
typestring
idstring | null
namestring | null
opted_in_atstring | null
updated_atstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/gmb-automation
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

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

Try it with MCPAsk your agent to call list-gmb-automation-audit (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

pageintegerdefault: 1

≥ 1

limitintegerdefault: 20

1–100

actionstring

opt_in_review_repliesopt_out_review_repliesopt_in_listing_editsopt_out_listing_editsautomated_review_reply

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
objectstring

gmb_automation_audit

idstring
account_idstring
location_idstring
actionstring
actorobject | null
Show 3 child attributes
typestring
idstring | null
namestring | null
detailsobject
created_atstring | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-automation/audit-log
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-automation/audit-log" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

GBP location details

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: readZernio: GET /v1/accounts/{accountId}/gmb-location-details

Try it with MCPAsk your agent to call get-gmb-location-details (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

read_maskstring

≤ 2000 characters

Returns object

objectstring

gmb_location_details

account_idstring
location_idstring | null
flagsobject | null
locationobject
update_maskarray of string | null
validate_onlyboolean
warningsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-location-details
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-location-details" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeZernio: PUT /v1/accounts/{accountId}/gmb-location-details

Try it with MCPAsk your agent to call update-gmb-location-details (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

Native Business Information Location fields (snake_case) plus update_mask / validate_only / location_id

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

update_maskstring | array of string
validate_onlyboolean
titlestring
regular_hoursobject
special_hoursobject
more_hoursarray of object
profileobject
website_uristring
phone_numbersobject
categoriesobject
service_itemsarray of object
store_codestring
labelsarray of string
storefront_addressobject
service_areaobject
open_infoobject
latlngobject
ad_words_location_extensionsobject

Returns object

objectstring

gmb_location_details

account_idstring
location_idstring | null
flagsobject | null
locationobject
update_maskarray of string | null
validate_onlyboolean
warningsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/gmb-location-details
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

GBP attributes

Get Google Business attributes

GET/accounts/{accountId}/gmb-attributes

Access: readZernio: GET /v1/accounts/{accountId}/gmb-attributes

Try it with MCPAsk your agent to call get-gmb-attributes (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_attributes

account_idstring
location_idstring | null
attributesarray of object
attribute_maskarray of string | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-attributes
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-attributes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeZernio: PUT /v1/accounts/{accountId}/gmb-attributes

Try it with MCPAsk your agent to call update-gmb-attributes (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

attributesarray of objectrequired

≤ 500 items

Show 4 item attributes
namestringrequired

≥ 1 characters

valuesarray of any
repeated_enum_valueobject
uri_valuesarray of any
attribute_maskstring | array of string

Returns object

objectstring

gmb_attributes

account_idstring
location_idstring | null
attributesarray of object
attribute_maskarray of string | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/gmb-attributes
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

GBP attribute metadata

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: readZernio: GET /v1/accounts/{accountId}/gmb-attribute-metadata

Try it with MCPAsk your agent to call get-gmb-attribute-metadata (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

category_namestring

≤ 300 characters

region_codestring

≤ 8 characters

language_codestring

≤ 35 characters

show_allboolean
limitinteger

1–200

cursorstring

≤ 2048 characters

Returns object

objectstringrequired

list

account_idstring
location_idstring | null
dataarray of objectrequired
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-attribute-metadata
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-attribute-metadata" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

GBP services

Get Google Business services

GET/accounts/{accountId}/gmb-services

Access: readZernio: GET /v1/accounts/{accountId}/gmb-services

Try it with MCPAsk your agent to call get-gmb-services (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_services

account_idstring
location_idstring | null
servicesarray of object
categoriesobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-services
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-services" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Replace Google Business services

PATCH/accounts/{accountId}/gmb-services

Access: writeZernio: PUT /v1/accounts/{accountId}/gmb-services

Try it with MCPAsk your agent to call replace-gmb-services (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

service_itemsarray of objectrequired

≤ 500 items

Returns object

objectstring

gmb_services

account_idstring
location_idstring | null
servicesarray of object
categoriesobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/gmb-services
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

GBP food menus

Get Google Business food menus

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

Access: readZernio: GET /v1/accounts/{accountId}/gmb-food-menus

Try it with MCPAsk your agent to call get-gmb-food-menus (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_food_menus

account_idstring
location_idstring | null
namestring | null
menusarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-food-menus
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-food-menus" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update Google Business food menus

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

Access: writeZernio: PUT /v1/accounts/{accountId}/gmb-food-menus

Try it with MCPAsk your agent to call update-gmb-food-menus (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

menusarray of objectrequired
update_maskstring

≤ 500 characters

Returns object

objectstring

gmb_food_menus

account_idstring
location_idstring | null
namestring | null
menusarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/gmb-food-menus
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

GBP media

List Google Business photos and videos

GET/accounts/{accountId}/gmb-media

Access: readZernio: GET /v1/accounts/{accountId}/gmb-media

Try it with MCPAsk your agent to call list-gmb-media (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

limitinteger

1–100

cursorstring

≤ 2048 characters

Returns object

objectstringrequired

list

account_idstring
location_idstring | null
totalinteger | null
dataarray of objectrequired
Show 14 item attributes
objectstring

gmb_media

idstring
namestring | null
media_formatstring | null
source_urlstring | null
google_urlstring | null
thumbnail_urlstring | null
descriptionstring | null
create_timestring | null
location_associationobject | null
dimensionsobject | null
insightsobject | null
attributionobject | null
warningsarray of string
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-media
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-media

Try it with MCPAsk your agent to call upload-gmb-media (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

source_urlstringrequired

8–4096 characters · pattern ^https?://

media_formatstring

PHOTOVIDEO

categorystring

CATEGORY_UNSPECIFIEDCOVERPROFILELOGOEXTERIORINTERIORPRODUCTAT_WORKFOOD_AND_DRINKMENUCOMMON_AREAROOMSTEAMSADDITIONAL

descriptionstring

≤ 1000 characters

Returns object

objectstring

gmb_media

idstring
namestring | null
media_formatstring | null
source_urlstring | null
google_urlstring | null
thumbnail_urlstring | null
descriptionstring | null
create_timestring | null
location_associationobject | null
dimensionsobject | null
insightsobject | null
attributionobject | null
warningsarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-media
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

Delete a Google Business photo or video

DELETE/accounts/{accountId}/gmb-media

Access: writeZernio: DELETE /v1/accounts/{accountId}/gmb-media

Try it with MCPAsk your agent to call delete-gmb-media (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

media_idstringrequired

1–500 characters

Returns object

objectstringrequired

gmb_media

idstringrequired
namestring | null
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/gmb-media
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-media?media_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

GBP place actions

List Google Business action links

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

Access: readZernio: GET /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call list-gmb-place-actions (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

limitinteger

1–100

cursorstring

≤ 2048 characters

filterstring

≤ 500 characters

Returns object

objectstringrequired

list

account_idstring
location_idstring | null
dataarray of objectrequired
Show 10 item attributes
objectstring

gmb_place_action_link

idstring
namestring | null
uristring | null
place_action_typestring | null
is_preferredboolean | null
is_editableboolean | null
provider_typestring | null
create_timestring | null
update_timestring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-place-actions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-place-actions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a Google Business action link

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

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call create-gmb-place-action (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

uristringrequired

8–4096 characters · pattern ^https?://

place_action_typestringrequired

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

is_preferredboolean

Returns object

objectstring

gmb_place_action_link

idstring
namestring | null
uristring | null
place_action_typestring | null
is_preferredboolean | null
is_editableboolean | null
provider_typestring | null
create_timestring | null
update_timestring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-place-actions
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

Update a Google Business action link

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

Access: writeZernio: PATCH /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call update-gmb-place-action (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

namestringrequired

1–500 characters

uristring

8–4096 characters · pattern ^https?://

place_action_typestring

APPOINTMENTONLINE_APPOINTMENTDINING_RESERVATIONFOOD_ORDERINGFOOD_DELIVERYFOOD_TAKEOUTSHOP_ONLINESOLOPRENEUR_APPOINTMENT

is_preferredboolean

Returns object

objectstring

gmb_place_action_link

idstring
namestring | null
uristring | null
place_action_typestring | null
is_preferredboolean | null
is_editableboolean | null
provider_typestring | null
create_timestring | null
update_timestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/gmb-place-actions
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

Delete a Google Business action link

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

Access: writeZernio: DELETE /v1/accounts/{accountId}/gmb-place-actions

Try it with MCPAsk your agent to call delete-gmb-place-action (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

namestringrequired

1–500 characters

Returns object

objectstringrequired

gmb_place_action_link

idstringrequired
namestring | null
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/gmb-place-actions
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-place-actions?name=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

GBP verifications

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: readZernio: GET /v1/accounts/{accountId}/gmb-verifications

Try it with MCPAsk your agent to call get-gmb-verifications (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

Returns object

objectstring

gmb_verification_state

account_idstring
location_idstring | null
summaryobject
Show 3 child attributes
statusstring
can_editboolean
messagestring | null
voice_of_merchant_stateobject
verificationsarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-verifications
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-verifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Start a Google Business verification

POST/accounts/{accountId}/gmb-verifications

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-verifications

Try it with MCPAsk your agent to call start-gmb-verification (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

methodstringrequired

ADDRESSEMAILPHONE_CALLSMSAUTOTRUSTED_PARTNERVETTED_PARTNER

language_codestring

≤ 35 characters

phone_numberstring

≤ 40 characters

email_addressstring

≤ 320 characters

mailer_contactobject
contextobject
trusted_partner_tokenstring

≤ 2000 characters

Returns object

objectstring

gmb_verification

account_idstring
location_idstring | null
verificationobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-verifications
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

Fetch Google Business verification options

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

Access: writeZernio: POST /v1/accounts/{accountId}/gmb-verifications/options

Try it with MCPAsk your agent to call fetch-gmb-verification-options (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

language_codestringrequired

2–35 characters

contextobject

Returns object

objectstring

gmb_verification_options

account_idstring
location_idstring | null
optionsarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-verifications/options
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

Complete a Google Business verification

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

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-verifications/{verificationId}/complete

Try it with MCPAsk your agent to call complete-gmb-verification (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

verificationIdstringrequired

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

location_idstring

Act on another location of the same Google login: locations/{id}, accounts/{a}/locations/{l} or a bare id

1–300 characters

pinstringrequired

1–20 characters

Returns object

objectstring

gmb_verification

account_idstring
location_idstring | null
verificationobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-verifications/{verificationId}/complete
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

GBP locations

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: readZernio: GET /v1/accounts/{accountId}/gmb-locations

Try it with MCPAsk your agent to call list-gmb-locations (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

searchstring

≤ 200 characters

filterstring

≤ 500 characters

limitintegerdefault: 100

1–500

google_account_idstring

≤ 300 characters

Returns object

objectstringrequired

list

account_idstring
selected_location_idstring | null
dataarray of objectrequired
Show 28 item attributes
objectstring

gmb_location

idstring
location_idstring | null
external_idstring | null
namestring | null
titlestring | null
google_account_idstring | null
google_account_namestring | null
google_account_typestring | null
addressstring | null
categorystring | null
store_codestring | null
phonestring | null
website_uristring | null
open_statusstring | null
labelsarray of string | null
place_idstring | null
maps_uristring | null
review_urlstring | null
is_verifiedboolean | null
has_pending_editsboolean | null
has_google_updatedboolean | null
can_have_food_menusboolean | null
can_operate_lodging_databoolean | null
can_operate_local_postboolean | null
can_modify_service_listboolean | null
duplicate_locationstring | object | null
connected_account_idstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/gmb-locations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/gmb-locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeZernio: PUT /v1/accounts/{accountId}/gmb-locations

Try it with MCPAsk your agent to call select-gmb-location (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

selected_location_idstringrequired

1–300 characters

google_account_idstring

≤ 300 characters

Returns object

objectstring

gmb_location_selection

account_idstring
messagestring
selected_locationobject
Show 28 child attributes
objectstring

gmb_location

idstring
location_idstring | null
external_idstring | null
namestring | null
titlestring | null
google_account_idstring | null
google_account_namestring | null
google_account_typestring | null
addressstring | null
categorystring | null
store_codestring | null
phonestring | null
website_uristring | null
open_statusstring | null
labelsarray of string | null
place_idstring | null
maps_uristring | null
review_urlstring | null
is_verifiedboolean | null
has_pending_editsboolean | null
has_google_updatedboolean | null
can_have_food_menusboolean | null
can_operate_lodging_databoolean | null
can_operate_local_postboolean | null
can_modify_service_listboolean | null
duplicate_locationstring | object | null
connected_account_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/gmb-locations
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

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: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/gmb-locations/assign

Try it with MCPAsk your agent to call assign-gmb-location (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

profile_idstringrequired

1–80 characters

selected_location_idstringrequired

1–300 characters

google_account_idstring

≤ 300 characters

Returns object

objectstring

gmb_location_assignment

messagestring
profile_idstring
selected_location_idstring | null
accountobject
Show 25 child attributes
objectstring

account

idstring
platformstring
connect_flowstring
account_typestring
profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstring
is_activeboolean
needs_reconnectboolean
scopesarray of string
token_expires_atstring | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring | null
created_atstring | null
updated_atstring | null

Responses

  • 200OK
  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/gmb-locations/assign
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

Facebook page

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: readZernio: GET /v1/accounts/{accountId}/facebook-page

Try it with MCPAsk your agent to call list-facebook-pages (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

refreshboolean

Returns object

objectstringrequired

list

account_idstring
selected_page_idstring | null
truncatedboolean
dataarray of objectrequired
Show 10 item attributes
objectstring

facebook_page

idstring
namestring | null
usernamestring | null
categorystring | null
picturestring | null
tasksarray of string
can_publishboolean
can_messageboolean
can_analyzeboolean
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook-page
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook-page" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeZernio: PUT /v1/accounts/{accountId}/facebook-page

Try it with MCPAsk your agent to call select-facebook-page (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

selected_page_idstringrequired

1–64 characters

Returns object

objectstring

facebook_page_selection

account_idstring
messagestring
previous_page_idstring | null
selected_pageobject
Show 2 child attributes
idstring
namestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook-page
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

Webhook subscription

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: readZernio: GET /v1/accounts/{accountId}/webhook-subscription

Try it with MCPAsk your agent to call get-facebook-webhook-subscription (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstring

facebook_webhook_subscription

account_idstring
page_idstring
app_subscribedboolean
subscribed_fieldsarray of string
missing_fieldsarray of string
leadgenboolean
appsarray of object
Show 2 item attributes
idstring
namestring | null
warningstring | null
resubscribedboolean | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/webhook-subscription
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/webhook-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Re-subscribe the Facebook Page to Socialit webhooks

POST/accounts/{accountId}/webhook-subscription

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/webhook-subscription

Try it with MCPAsk your agent to call resubscribe-facebook-webhooks (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object | null

fieldsarray of string

≤ 50 items

Returns object

objectstring

facebook_webhook_subscription

account_idstring
page_idstring
app_subscribedboolean
subscribed_fieldsarray of string
missing_fieldsarray of string
leadgenboolean
appsarray of object
Show 2 item attributes
idstring
namestring | null
warningstring | null
resubscribedboolean | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/webhook-subscription
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

Business partners

List partner businesses of the Page

GET/accounts/{accountId}/business-partners

Access: readZernio: GET /v1/accounts/{accountId}/business-partners

Try it with MCPAsk your agent to call list-facebook-business-partners (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

account_idstring
pageobject | null
Show 3 child attributes
idstring
namestring | null
businessobject | null
Show 2 child attributes
idstring
namestring | null
dataarray of objectrequired
Show 4 item attributes
objectstring

facebook_business_partner

idstring
namestring | null
permitted_tasksarray of string | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/business-partners
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/business-partners" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/business-partners

Try it with MCPAsk your agent to call share-facebook-page-with-partner (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

business_idstringrequired

pattern ^[0-9]{1,32}$

permitted_tasksarray of string

1–40 items

Returns object

objectstring

facebook_business_partner_share

account_idstring
pageobject | null
Show 3 child attributes
idstring
namestring | null
businessobject | null
Show 2 child attributes
idstring
namestring | null
partnerobject
Show 2 child attributes
idstring
permitted_tasksarray of string
already_sharedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/business-partners
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

Revoke a partner business from the Page

DELETE/accounts/{accountId}/business-partners

Access: writeZernio: DELETE /v1/accounts/{accountId}/business-partners

Try it with MCPAsk your agent to call revoke-facebook-business-partner (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

business_idstringrequired

pattern ^[0-9]{1,32}$

Returns object

objectstringrequired

facebook_business_partner

idstringrequired
page_idstring | null
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/business-partners
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/business-partners?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn organizations

List LinkedIn organizations

GET/accounts/{accountId}/linkedin-organizations

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

Access: readZernio: GET /v1/accounts/{accountId}/linkedin-organizations

Try it with MCPAsk your agent to call list-linkedin-organizations (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

account_idstring
dataarray of objectrequired
Show 10 item attributes
objectstring

linkedin_organization

idstring
urnstring
namestring | null
localized_namestring | null
vanity_namestring | null
logo_urlstring | null
rolesarray of string
can_postboolean
is_adminboolean
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin-organizations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin-organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

LinkedIn organization

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: writeZernio: PUT /v1/accounts/{accountId}/linkedin-organization

Try it with MCPAsk your agent to call switch-linkedin-account-type (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

account_typestringrequired

personalorganization

selected_organizationstring | object
One of 2 shapes

Option 1 string

Option 2 object

idstring | integer
urnstring

Returns object

objectstring

linkedin_account_type

account_idstring
account_typestring
account_namestring | null
messagestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/linkedin-organization
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

LinkedIn mentions

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: readZernio: GET /v1/accounts/{accountId}/linkedin-mentions

Try it with MCPAsk your agent to call resolve-linkedin-mention (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

urlstringrequired

3–2000 characters

display_namestring

≤ 200 characters

organization_urnstring

≤ 200 characters

Returns object

objectstring

linkedin_mention

urnstring
typestring
display_namestring | null
mention_formatstring | null
vanity_namestring | null
warningstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/linkedin-mentions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/linkedin-mentions?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Instagram

List active Instagram stories

GET/accounts/{accountId}/instagram/stories

Access: readZernio: GET /v1/accounts/{accountId}/instagram/stories

Try it with MCPAsk your agent to call list-instagram-stories (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitinteger

1–100

cursorstring

≤ 2048 characters

Returns object

objectstringrequired

list

account_idstring
dataarray of objectrequired
Show 8 item attributes
objectstring

instagram_story

idstring
media_typestring | null
media_product_typestring | null
media_urlstring | null
thumbnail_urlstring | null
permalinkstring | null
timestampstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/instagram/stories
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: readZernio: GET /v1/accounts/{accountId}/instagram/stories/{storyId}/insights

Try it with MCPAsk your agent to call get-instagram-story-insights (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

storyIdstringrequired

1–128 characters

Returns object

objectstring

instagram_story_insights

story_idstring
sourcestring
reasonstring | null
viewsinteger
reachinteger
repliesinteger
sharesinteger
profile_visitsinteger
followsinteger
total_interactionsinteger
navigationinteger
taps_forwardinteger
taps_backinteger
exitsinteger
swipes_forwardinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/instagram/stories/{storyId}/insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/stories/STORY_ID/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get Instagram publishing limit

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

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

Access: readZernio: GET /v1/accounts/{accountId}/instagram/publishing-limit

Try it with MCPAsk your agent to call get-instagram-publishing-limit (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstring

instagram_publishing_limit

account_idstring
quota_usageinteger
quota_totalinteger
quota_duration_secondsinteger
remaininginteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/instagram/publishing-limit
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/publishing-limit" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Search Instagram audio

GET/accounts/{accountId}/instagram/audio

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

Access: readZernio: GET /v1/accounts/{accountId}/instagram/audio

Try it with MCPAsk your agent to call search-instagram-audio (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

audio_typestringdefault: "music"

musicoriginal_sound

qstring

≤ 200 characters

limitinteger

1–100

cursorstring

≤ 2048 characters

Returns object

objectstringrequired

list

account_idstring
dataarray of objectrequired
Show 12 item attributes
objectstring

instagram_audio

audio_idstring
titlestring | null
duration_in_msinteger | null
audio_typestring | null
display_artiststring | null
ig_usernamestring | null
profile_picture_urlstring | null
download_urlstring | null
preview_urlstring | null
cover_artwork_urlstring | null
is_ads_eligibleboolean | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/instagram/audio
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/audio" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: readZernio: GET /v1/accounts/{accountId}/instagram/audio/{audioId}

Try it with MCPAsk your agent to call get-instagram-audio (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

audioIdstringrequired

1–128 characters

Returns object

objectstring

instagram_audio

audio_idstring
titlestring | null
duration_in_msinteger | null
audio_typestring | null
display_artiststring | null
ig_usernamestring | null
profile_picture_urlstring | null
download_urlstring | null
preview_urlstring | null
cover_artwork_urlstring | null
is_ads_eligibleboolean | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/instagram/audio/{audioId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/audio/AUDIO_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: readZernio: GET /v1/accounts/{accountId}/instagram/business-discovery

Try it with MCPAsk your agent to call instagram-business-discovery (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

usernamestringrequired

pattern ^@?[A-Za-z0-9._]{1,30}$

limitintegerdefault: 12

1–50

cursorstring

≤ 2048 characters

Returns object

objectstring

instagram_business_discovery

profileobject
Show 10 child attributes
idstring
ig_idinteger | string | null
usernamestring | null
namestring | null
biographystring | null
websitestring | null
profile_picture_urlstring | null
followers_countinteger | null
follows_countinteger | null
media_countinteger | null
mediaarray of object
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/instagram/business-discovery
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/business-discovery?username=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Follow status

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: readZernio: GET /v1/accounts/{accountId}/follow-status/{userId}

Try it with MCPAsk your agent to call get-instagram-follow-status (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

userIdstringrequired

1–128 characters

Query parameters

refreshboolean

Returns object

objectstring

instagram_follow_status

account_idstring
user_idstring
is_followerboolean | null
is_followed_by_accountboolean | null
follower_countinteger | null
is_verifiedboolean | null
usernamestring | null
namestring | null
unavailable_reasonstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/follow-status/{userId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/follow-status/USER_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest boards

List Pinterest boards

GET/accounts/{accountId}/pinterest-boards

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

Access: readZernio: GET /v1/accounts/{accountId}/pinterest-boards

Try it with MCPAsk your agent to call list-pinterest-boards (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

account_idstring
default_board_idstring | null
default_board_namestring | null
dataarray of objectrequired
Show 14 item attributes
objectstring

pinterest_board

idstring
namestring | null
descriptionstring | null
privacystring | null
urlstring | null
pin_countinteger | null
follower_countinteger | null
collaborator_countinteger | null
is_ads_onlyboolean | null
image_cover_urlstring | null
owner_usernamestring | null
created_atstring | null
board_pins_modified_atstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest-boards
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest-boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a Pinterest board

POST/accounts/{accountId}/pinterest-boards

SECRET boards need the boards:write_secret scope.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/pinterest-boards

Try it with MCPAsk your agent to call create-pinterest-board (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

namestringrequired

1–180 characters

descriptionstring

≤ 500 characters

privacystring

PUBLICPROTECTEDSECRET

Returns object

objectstring

pinterest_board

idstring
namestring | null
descriptionstring | null
privacystring | null
urlstring | null
pin_countinteger | null
follower_countinteger | null
collaborator_countinteger | null
is_ads_onlyboolean | null
image_cover_urlstring | null
owner_usernamestring | null
created_atstring | null
board_pins_modified_atstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest-boards
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

Set the default Pinterest board

PATCH/accounts/{accountId}/pinterest-boards

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

Access: writeZernio: PUT /v1/accounts/{accountId}/pinterest-boards

Try it with MCPAsk your agent to call set-default-pinterest-board (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

default_board_idstringrequired

1–64 characters

default_board_namestring

≤ 180 characters

Returns object

objectstring

pinterest_default_board

account_idstring
default_board_idstring
default_board_namestring | null
messagestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/pinterest-boards
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

YouTube playlists

List YouTube playlists

GET/accounts/{accountId}/youtube-playlists

Every playlist of the channel plus the stored default playlist.

Access: readZernio: GET /v1/accounts/{accountId}/youtube-playlists

Try it with MCPAsk your agent to call list-youtube-playlists (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

account_idstring
default_playlist_idstring | null
default_playlist_namestring | null
dataarray of objectrequired
Show 9 item attributes
objectstring

youtube_playlist

idstring
titlestring | null
descriptionstring | null
privacystring | null
item_countinteger | null
thumbnail_urlstring | null
published_atstring | null
urlstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube-playlists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube-playlists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a YouTube playlist

POST/accounts/{accountId}/youtube-playlists

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

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/youtube-playlists

Try it with MCPAsk your agent to call create-youtube-playlist (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

titlestringrequired

1–150 characters

descriptionstring

≤ 5000 characters

privacystringdefault: "private"

privatepublicunlisted

default_languagestring

≤ 35 characters

Returns object

objectstring

youtube_playlist

idstring
titlestring | null
descriptionstring | null
privacystring | null
item_countinteger | null
thumbnail_urlstring | null
published_atstring | null
urlstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/youtube-playlists
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

Set the default YouTube playlist

PATCH/accounts/{accountId}/youtube-playlists

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

Access: writeZernio: PUT /v1/accounts/{accountId}/youtube-playlists

Try it with MCPAsk your agent to call set-default-youtube-playlist (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

default_playlist_idstringrequired

1–64 characters

default_playlist_namestring

≤ 150 characters

Returns object

objectstring

youtube_default_playlist

account_idstring
default_playlist_idstring
default_playlist_namestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/youtube-playlists
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

YouTube captions

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: readZernio: GET /v1/accounts/{accountId}/youtube-captions

Try it with MCPAsk your agent to call get-youtube-transcript (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

video_idstringrequired

1–64 characters

languagestring

≤ 35 characters

formatstringdefault: "json"

jsonsrtvtt

track_idstring

≤ 200 characters

tlangstring

≤ 35 characters

refreshboolean

Returns object

objectstring

youtube_transcript

account_idstring
video_idstring
languagestring | null
track_idstring | null
track_kindstring | null
sourcestring
fetched_atstring | null
textstring | null
cuesarray of object
Show 3 item attributes
startnumber | null
endnumber | null
textstring | null
srtstring | null
vttstring | null
available_tracksarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/youtube-captions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/youtube-captions?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reddit subreddits

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: readZernio: GET /v1/accounts/{accountId}/reddit-subreddits

Try it with MCPAsk your agent to call list-reddit-subreddits (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

wherestringdefault: "postable"

postablesubscribermoderatorcontributor

limitinteger

1–100

cursorstring

≤ 200 characters

Returns object

objectstringrequired

list

account_idstring
default_subredditstring | null
dataarray of objectrequired
Show 16 item attributes
objectstring

reddit_subreddit

idstring | null
namestring | null
prefixed_namestring | null
titlestring | null
descriptionstring | null
subscribersinteger | null
active_usersinteger | null
typestring | null
over_18boolean | null
quarantinedboolean | null
submission_typestring | null
post_typesobject
user_is_moderatorboolean | null
user_is_contributorboolean | null
user_is_subscriberboolean | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/reddit-subreddits
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-subreddits" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set the default subreddit

PATCH/accounts/{accountId}/reddit-subreddits

Validates the subreddit exists. Emits account.updated.

Access: writeZernio: PUT /v1/accounts/{accountId}/reddit-subreddits

Try it with MCPAsk your agent to call set-default-reddit-subreddit (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

default_subredditstringrequired

1–64 characters

Returns object

objectstring

reddit_default_subreddit

account_idstring
default_subredditstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit-subreddits
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

Get subreddit rules

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

Access: readZernio: GET /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules

Try it with MCPAsk your agent to call get-reddit-subreddit-rules (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

subredditstringrequired

1–64 characters

Returns object

objectstring

reddit_subreddit_rules

subredditstring
rulesarray of object
Show 7 item attributes
idstring | null
priorityinteger | null
short_namestring | null
descriptionstring | null
violation_reasonstring | null
kindstring | null
created_atstring | null
site_rulesarray of string
site_rules_flowarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/reddit-subreddits/{subreddit}/rules
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-subreddits/SUBREDDIT/rules" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reddit flairs

List subreddit post flairs

GET/accounts/{accountId}/reddit-flairs

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

Access: readZernio: GET /v1/accounts/{accountId}/reddit-flairs

Try it with MCPAsk your agent to call list-reddit-flairs (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstringrequired

1–64 characters

Returns object

objectstringrequired

list

account_idstring
subredditstring
restrictedboolean
dataarray of objectrequired
Show 12 item attributes
objectstring

reddit_flair

idstring
textstring | null
text_colorstring | null
background_colorstring | null
text_editableboolean
typestring | null
richtextarray of any
mod_onlyboolean
allowable_contentstring | null
max_emojisinteger | null
css_classstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/reddit-flairs
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit-flairs?subreddit=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set a Reddit post flair

POST/accounts/{accountId}/reddit-flairs

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/reddit-flairs

Try it with MCPAsk your agent to call set-reddit-post-flair (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

subredditstring

1–64 characters

post_idstringrequired

1–32 characters

flair_template_idstringrequired

1–64 characters

textstring

≤ 64 characters

Returns object

objectstring

reddit_post_flair

account_idstring
post_idstring
flair_template_idstring
textstring | null
successboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit-flairs
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

Reddit vote

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: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/reddit-vote

Try it with MCPAsk your agent to call vote-on-reddit (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

thing_idstringrequired

2–32 characters

directionintegerrequired

10-1

Returns object

objectstring

reddit_vote

account_idstring
thing_idstring
directioninteger
successboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit-vote
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

TikTok

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: readZernio: GET /v1/accounts/{accountId}/tiktok/creator-info

Try it with MCPAsk your agent to call get-tiktok-creator-info (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

media_typestringdefault: "video"

videophoto

Returns object

objectstring

tiktok_creator_info

account_idstring
lanestring
creatorobject
Show 6 child attributes
nicknamestring | null
usernamestring | null
avatar_urlstring | null
is_verifiedboolean | null
can_post_moreboolean
reasonstring | number | null
privacy_levelsarray of object
Show 2 item attributes
valuestring
labelstring | null
posting_limitsobject
Show 2 child attributes
max_video_duration_secinteger | null
interaction_settingsobject
Show 3 child attributes
allow_commentobject | null
Show 4 child attributes
enabledboolean
requiredboolean
defaultboolean
labelstring | null
allow_duetobject | null
Show 4 child attributes
enabledboolean
requiredboolean
defaultboolean
labelstring | null
allow_stitchobject | null
Show 4 child attributes
enabledboolean
requiredboolean
defaultboolean
labelstring | null
commercial_content_typesarray of object
Show 3 item attributes
valuestring
labelstring | null
requiresstring | null
warningstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/creator-info
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/creator-info" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call get-tiktok-composer-requirements (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

media_typestringdefault: "video"

videophoto

Returns object

objectstring

tiktok_composer_requirements

account_idstring
lanestring
media_typestring
fetched_atstring
creatorobject
Show 9 child attributes
nicknamestring | null
usernamestring | null
avatar_urlstring | null
avatar_ttl_secondsinteger | null
must_displayarray of string
can_postboolean
cannot_post_reasonstring | number | null
cannot_post_messagestring | null
warningstring | null
privacyobject
Show 5 child attributes
optionsarray of object
Show 3 item attributes
valuestring
labelstring
allowed_with_branded_contentboolean
defaultstring | null
requiredboolean
controlstring
direct_post_forcedstring | null
interactionsobject
Show 3 child attributes
commentobject | null
Show 5 child attributes
labelstring
availableboolean
disabled_by_creatorboolean
defaultboolean
required_user_actionboolean
duetobject | null
Show 5 child attributes
labelstring
availableboolean
disabled_by_creatorboolean
defaultboolean
required_user_actionboolean
stitchobject | null
Show 5 child attributes
labelstring
availableboolean
disabled_by_creatorboolean
defaultboolean
required_user_actionboolean
max_video_duration_secinteger | null
commercial_contentobject
Show 6 child attributes
toggleobject
Show 2 child attributes
labelstring
defaultboolean
optionsarray of object
Show 7 item attributes
valuestring
labelstring
maps_tostring
noticestring | null
defaultboolean
disallowed_privacyarray of string
disallowed_privacy_tooltipstring
multi_selectboolean
both_selected_noticestring | null
selection_required_when_onboolean
publish_disabled_tooltipstring
declarationobject
Show 5 child attributes
positionstring
defaultstring
your_brand_onlystring
branded_contentstring
linksobject
Show 2 child attributes
musicUsageConfirmationstring
brandedContentPolicystring
noticesobject
Show 2 child attributes
processingstring
draftstring
rulesmap of boolean
limitsobject
Show 7 child attributes
title_maxinteger | null
description_maxinteger | null
photos_maxinteger | null
formatsarray of string
max_bytesinteger | null
posts_per_dayinteger | null
pending_draftsinteger | null
featuresmap of boolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/composer
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/composer" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List trending TikTok commercial music

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

Commercial Music Library tracks (TikTok Business connections).

Access: readZernio: GET /v1/accounts/{accountId}/tiktok/commercial-music

Try it with MCPAsk your agent to call list-tiktok-commercial-music (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

country_codestring

pattern ^[A-Za-z]{2}$

genrestring

≤ 64 characters

date_rangestring

1DAY7DAY30DAY90DAY

Returns object

objectstringrequired

list

account_idstring
dataarray of objectrequired
Show 12 item attributes
objectstring

tiktok_music_track

idstring | null
commercial_music_idstring | null
namestring | null
artiststring | null
duration_secnumber | null
genresarray of string
preview_urlstring | null
thumbnail_urlstring | null
rankinteger | null
trending_historyarray of object
clipobject | null
Show 3 child attributes
idstring | null
duration_secnumber | null
preview_urlstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/commercial-music
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/commercial-music" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Search TikTok location tags

GET/accounts/{accountId}/tiktok/locations

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

Access: readZernio: GET /v1/accounts/{accountId}/tiktok/locations

Try it with MCPAsk your agent to call search-tiktok-locations (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

querystringrequired

1–100 characters

Returns object

objectstringrequired

list

account_idstring
dataarray of objectrequired
Show 4 item attributes
objectstring

tiktok_location

idstring | null
namestring | null
addressstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/locations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/locations?query=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky settings

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: readZernio: GET /v1/accounts/{accountId}/bluesky-settings

Try it with MCPAsk your agent to call get-bluesky-settings (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstring

bluesky_settings

account_idstring
default_langsarray of string | null
default_threadgatearray of string | null
default_postgateobject | null
Show 1 child attributes
disable_quotesboolean
default_labelsarray of string
default_tagsarray of string
auto_facetsboolean
auto_link_cardsboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky-settings
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update Bluesky account settings

PATCH/accounts/{accountId}/bluesky-settings

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

Access: writeZernio: PATCH /v1/accounts/{accountId}/bluesky-settings

Try it with MCPAsk your agent to call update-bluesky-settings (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

default_langsarray of string | null

≤ 3 items

default_threadgatearray of string | null

≤ 5 items

default_postgateobject | null
Show 1 child attributes
disable_quotesboolean
default_labelsarray of string

≤ 4 items

default_tagsarray of string

≤ 8 items

auto_facetsboolean
auto_link_cardsboolean

Returns object

objectstring

bluesky_settings

account_idstring
default_langsarray of string | null
default_threadgatearray of string | null
default_postgateobject | null
Show 1 child attributes
disable_quotesboolean
default_labelsarray of string
default_tagsarray of string
auto_facetsboolean
auto_link_cardsboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky-settings
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

Discord settings

Get Discord account settings

GET/accounts/{accountId}/discord-settings

Access: readZernio: GET /v1/accounts/{accountId}/discord-settings

Try it with MCPAsk your agent to call get-discord-settings (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstring

discord_settings

account_idstring
modestring
guild_idstring | null
guild_namestring | null
channel_idstring | null
channel_namestring | null
channel_typeinteger | string | null
webhook_usernamestring | null
webhook_avatar_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/discord-settings
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeZernio: PATCH /v1/accounts/{accountId}/discord-settings

Try it with MCPAsk your agent to call update-discord-settings (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

webhook_usernamestring | null

≤ 80 characters

webhook_avatar_urlstring | null

≤ 2048 characters

channel_idstring

pattern ^[0-9]{5,25}$

Returns object

objectstring

discord_settings

account_idstring
modestring
guild_idstring | null
guild_namestring | null
channel_idstring | null
channel_namestring | null
channel_typeinteger | string | null
webhook_usernamestring | null
webhook_avatar_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/discord-settings
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

Discord channels

List Discord server channels

GET/accounts/{accountId}/discord-channels

Access: readZernio: GET /v1/accounts/{accountId}/discord-channels

Try it with MCPAsk your agent to call list-discord-channels (toolset platform_tools)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

typesstring

pattern ^[0-9]+(,[0-9]+)*$

Returns object

objectstringrequired

list

account_idstring
dataarray of objectrequired
Show 10 item attributes
objectstring

discord_channel

idstring
namestring | null
typeinteger
type_namestring | null
parent_idstring | null
positioninteger
topicstring | null
nsfwboolean
postableboolean
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/discord-channels
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord-channels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord

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: writeIdempotency-KeyZernio: POST /v1/discord/dms

Try it with MCPAsk your agent to call send-discord-dm (toolset platform_tools)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

account_idstringrequired

Social account id (sa_…)

1–80 characters

user_idstringrequired

pattern ^[0-9]{5,25}$

contentstring

≤ 2000 characters

embedsarray of object

≤ 10 items

attachmentsarray of object

≤ 10 items

Show 5 item attributes
typestringrequired

imagevideogifdocument

urlstringrequired

≤ 4096 characters · pattern ^https?://

filenamestring

≤ 200 characters

mime_typestring

≤ 100 characters

sizeinteger
ttsboolean

Returns object

objectstring

discord_dm

account_idstring
message_idstring | null
channel_idstring | null
urlstring | null
timestampstring | null
recipientobject
Show 2 child attributes
user_idstring
platformstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/discord/dms
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

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: readZernio: GET /v1/discord/guilds/{guildId}/roles

Try it with MCPAsk your agent to call list-discord-roles (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

account_idstring
guild_idstring
dataarray of objectrequired
Show 12 item attributes
objectstring

discord_role

idstring
namestring | null
colorinteger
positioninteger
permissionsstring | null
permission_namesarray of string
managedboolean
mentionableboolean
hoistboolean
iconstring | null
unicode_emojistring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/discord/guilds/{guildId}/roles
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/roles?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/discord/guilds/{guildId}/roles

Try it with MCPAsk your agent to call create-discord-role (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

namestringrequired

1–100 characters

colorinteger | string
hoistboolean
mentionableboolean
permissionsstring | array of string
unicode_emojistring | null

≤ 32 characters

reasonstring

≤ 512 characters

Returns object

objectstring

discord_role

idstring
namestring | null
colorinteger
positioninteger
permissionsstring | null
permission_namesarray of string
managedboolean
mentionableboolean
hoistboolean
iconstring | null
unicode_emojistring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/discord/guilds/{guildId}/roles
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

Edit a Discord server role

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

Access: writeZernio: PATCH /v1/discord/guilds/{guildId}/roles/{roleId}

Try it with MCPAsk your agent to call update-discord-role (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

roleIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

Body object

namestring

1–100 characters

colorinteger | string
hoistboolean
mentionableboolean
permissionsstring | array of string
unicode_emojistring | null

≤ 32 characters

reasonstring

≤ 512 characters

Returns object

objectstring

discord_role

idstring
namestring | null
colorinteger
positioninteger
permissionsstring | null
permission_namesarray of string
managedboolean
mentionableboolean
hoistboolean
iconstring | null
unicode_emojistring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/discord/guilds/{guildId}/roles/{roleId}
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

Delete a Discord server role

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

Access: writeZernio: DELETE /v1/discord/guilds/{guildId}/roles/{roleId}

Try it with MCPAsk your agent to call delete-discord-role (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

roleIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

reasonstring

≤ 512 characters

Returns object

objectstringrequired

discord_role

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/discord/guilds/{guildId}/roles/{roleId}
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

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: readZernio: GET /v1/discord/guilds/{guildId}/members

Try it with MCPAsk your agent to call list-discord-members (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

limitintegerdefault: 100

1–1000

afterstring

pattern ^[0-9]{5,25}$

Returns object

objectstringrequired

list

account_idstring
guild_idstring
intent_missingboolean
dataarray of objectrequired
Show 14 item attributes
objectstring

discord_member

idstring
usernamestring | null
global_namestring | null
nickstring | null
display_namestring | null
avatarstring | null
botboolean
rolesarray of string
joined_atstring | null
premium_sincestring | null
pendingboolean
communication_disabled_untilstring | null
flagsinteger
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/discord/guilds/{guildId}/members
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/members?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Search Discord server members

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

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

Access: readZernio: GET /v1/discord/guilds/{guildId}/members/search

Try it with MCPAsk your agent to call search-discord-members (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

querystringrequired

1–100 characters

limitintegerdefault: 25

1–1000

Returns object

objectstringrequired

list

account_idstring
guild_idstring
intent_missingboolean
dataarray of objectrequired
Show 14 item attributes
objectstring

discord_member

idstring
usernamestring | null
global_namestring | null
nickstring | null
display_namestring | null
avatarstring | null
botboolean
rolesarray of string
joined_atstring | null
premium_sincestring | null
pendingboolean
communication_disabled_untilstring | null
flagsinteger
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/discord/guilds/{guildId}/members/search
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

Get a Discord server member

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

Access: readZernio: GET /v1/discord/guilds/{guildId}/members/{userId}

Try it with MCPAsk your agent to call get-discord-member (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

userIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstring

discord_member

idstring
usernamestring | null
global_namestring | null
nickstring | null
display_namestring | null
avatarstring | null
botboolean
rolesarray of string
joined_atstring | null
premium_sincestring | null
pendingboolean
communication_disabled_untilstring | null
flagsinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/discord/guilds/{guildId}/members/{userId}
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

Assign a role to a Discord member

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

Access: writeZernio: PUT /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}

Try it with MCPAsk your agent to call add-discord-member-role (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

userIdstringrequired

1–512 characters

roleIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

reasonstring

≤ 512 characters

Returns object

objectstring

discord_member_role

guild_idstring
user_idstring
role_idstring
operationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PUT/discord/guilds/{guildId}/members/{userId}/roles/{roleId}
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

Remove a role from a Discord member

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

Access: writeZernio: DELETE /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}

Try it with MCPAsk your agent to call remove-discord-member-role (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

userIdstringrequired

1–512 characters

roleIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

reasonstring

≤ 512 characters

Returns object

objectstring

discord_member_role

guild_idstring
user_idstring
role_idstring
operationstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/discord/guilds/{guildId}/members/{userId}/roles/{roleId}
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

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: writeZernio: DELETE /v1/discord/channels/{channelId}/messages/{messageId}

Try it with MCPAsk your agent to call delete-discord-message (toolset platform_tools)Set up MCP

Path parameters

channelIdstringrequired

1–512 characters

messageIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

reasonstring

≤ 512 characters

Returns object

objectstringrequired

discord_message

idstringrequired
channel_idstring
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/discord/channels/{channelId}/messages/{messageId}
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

Crosspost a Discord announcement

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

Publish an announcement-channel message to every following server.

Access: writeIdempotency-KeyZernio: POST /v1/discord/channels/{channelId}/messages/{messageId}/crosspost

Try it with MCPAsk your agent to call crosspost-discord-message (toolset platform_tools)Set up MCP

Path parameters

channelIdstringrequired

1–512 characters

messageIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstring

discord_crosspost

idstring
channel_idstring
messageobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/discord/channels/{channelId}/messages/{messageId}/crosspost
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

Create a Discord public thread

POST/discord/channels/{channelId}/threads

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

Access: writeIdempotency-KeyZernio: POST /v1/discord/channels/{channelId}/threads

Try it with MCPAsk your agent to call create-discord-thread (toolset platform_tools)Set up MCP

Path parameters

channelIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

namestringrequired

1–100 characters

message_idstring

pattern ^[0-9]{5,25}$

auto_archive_durationinteger

601440432010080

rate_limit_per_userinteger

0–21600

reasonstring

≤ 512 characters

Returns object

objectstring

discord_thread

idstring
namestring | null
parent_idstring | null
threadobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/discord/channels/{channelId}/threads
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

List pinned Discord messages

GET/discord/channels/{channelId}/pins

Access: readZernio: GET /v1/discord/channels/{channelId}/pins

Try it with MCPAsk your agent to call list-discord-pins (toolset platform_tools)Set up MCP

Path parameters

channelIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

beforestring

≤ 40 characters

limitintegerdefault: 50

1–50

Returns object

objectstringrequired

list

account_idstring
channel_idstring
dataarray of objectrequired
Show 9 item attributes
objectstring

discord_pinned_message

idstring
channel_idstring | null
contentstring | null
timestampstring | null
pinned_atstring | null
authorobject
attachmentsarray of object
embedsarray of object
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/discord/channels/{channelId}/pins
curl "https://api.socialit.com/v1/discord/channels/CHANNEL_ID/pins?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pin a Discord message

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

Access: writeZernio: PUT /v1/discord/channels/{channelId}/pins/{messageId}

Try it with MCPAsk your agent to call pin-discord-message (toolset platform_tools)Set up MCP

Path parameters

channelIdstringrequired

1–512 characters

messageIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

reasonstring

≤ 512 characters

Returns object

objectstring

discord_pin

channel_idstring
message_idstring
pinnedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PUT/discord/channels/{channelId}/pins/{messageId}
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

Unpin a Discord message

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

Access: writeZernio: DELETE /v1/discord/channels/{channelId}/pins/{messageId}

Try it with MCPAsk your agent to call unpin-discord-message (toolset platform_tools)Set up MCP

Path parameters

channelIdstringrequired

1–512 characters

messageIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

reasonstring

≤ 512 characters

Returns object

objectstring

discord_pin

channel_idstring
message_idstring
pinnedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/discord/channels/{channelId}/pins/{messageId}
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

List Discord scheduled events

GET/discord/guilds/{guildId}/events

Access: readZernio: GET /v1/discord/guilds/{guildId}/events

Try it with MCPAsk your agent to call list-discord-events (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

with_user_countbooleandefault: true

Returns object

objectstringrequired

list

account_idstring
guild_idstring
dataarray of objectrequired
Show 15 item attributes
objectstring

discord_scheduled_event

idstring
guild_idstring | null
namestring | null
descriptionstring | null
starts_atstring | null
ends_atstring | null
statusstring | integer
entity_typestring | integer
channel_idstring | null
locationstring | null
user_countinteger | null
imagestring | null
recurrence_ruleobject | null
creator_idstring | null
has_morebooleanrequired
next_cursorstring | nullrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/discord/guilds/{guildId}/events
curl "https://api.socialit.com/v1/discord/guilds/GUILD_ID/events?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a Discord scheduled event

POST/discord/guilds/{guildId}/events

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

Access: writeIdempotency-KeyZernio: POST /v1/discord/guilds/{guildId}/events

Try it with MCPAsk your agent to call create-discord-event (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

account_idstringrequired

Social account id (sa_…)

1–80 characters

namestringrequired

1–100 characters

descriptionstring

≤ 1000 characters

starts_atstringrequired

10–40 characters

ends_atstring

10–40 characters

entityobjectrequired
Show 4 child attributes
typestringrequired

externalvoicestage

locationstring

≤ 100 characters

channel_idstring

pattern ^[0-9]{5,25}$

ends_atstring

10–40 characters

image_data_uristring | null

data: URI or https URL (null clears on update)

≤ 12000000 characters

recurrence_ruleobject
reasonstring

≤ 512 characters

Returns object

objectstring

discord_scheduled_event

idstring
guild_idstring | null
namestring | null
descriptionstring | null
starts_atstring | null
ends_atstring | null
statusstring | integer
entity_typestring | integer
channel_idstring | null
locationstring | null
user_countinteger | null
imagestring | null
recurrence_ruleobject | null
creator_idstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/discord/guilds/{guildId}/events
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

Get a Discord scheduled event

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

Access: readZernio: GET /v1/discord/guilds/{guildId}/events/{eventId}

Try it with MCPAsk your agent to call get-discord-event (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

eventIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

with_user_countbooleandefault: true

Returns object

objectstring

discord_scheduled_event

idstring
guild_idstring | null
namestring | null
descriptionstring | null
starts_atstring | null
ends_atstring | null
statusstring | integer
entity_typestring | integer
channel_idstring | null
locationstring | null
user_countinteger | null
imagestring | null
recurrence_ruleobject | null
creator_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/discord/guilds/{guildId}/events/{eventId}
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

Update a Discord scheduled event

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

Access: writeZernio: PATCH /v1/discord/guilds/{guildId}/events/{eventId}

Try it with MCPAsk your agent to call update-discord-event (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

eventIdstringrequired

1–512 characters

Body object

account_idstringrequired

Social account id (sa_…)

1–80 characters

namestring

1–100 characters

descriptionstring | null

≤ 1000 characters

starts_atstring

10–40 characters

ends_atstring | null

≤ 40 characters

locationstring

≤ 100 characters

statusstring

scheduledactivecompletedcancelled

image_data_uristring | null

data: URI or https URL (null clears on update)

≤ 12000000 characters

recurrence_ruleobject | null
reasonstring

≤ 512 characters

Returns object

objectstring

discord_scheduled_event

idstring
guild_idstring | null
namestring | null
descriptionstring | null
starts_atstring | null
ends_atstring | null
statusstring | integer
entity_typestring | integer
channel_idstring | null
locationstring | null
user_countinteger | null
imagestring | null
recurrence_ruleobject | null
creator_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/discord/guilds/{guildId}/events/{eventId}
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

Delete a Discord scheduled event

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

Access: writeZernio: DELETE /v1/discord/guilds/{guildId}/events/{eventId}

Try it with MCPAsk your agent to call delete-discord-event (toolset platform_tools)Set up MCP

Path parameters

guildIdstringrequired

1–512 characters

eventIdstringrequired

1–512 characters

Query parameters

account_idstringrequired

Social account id (sa_…)

1–80 characters

reasonstring

≤ 512 characters

Returns object

objectstringrequired

discord_scheduled_event

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/discord/guilds/{guildId}/events/{eventId}
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