Skip to content
Docs

Reusable post content with media and network options.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits5 endpointsMCP toolset templates

List templates

GET/templates

Access: read

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

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atnameupdated_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

searchstring

≤ 200 characters

tagstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
objectstring

template

idstring
namestring
aliasstring | null
contentstring
mediaarray of object
Show 5 item attributes
media_idstring
typestring
urlstring | null
thumbnail_urlstring | null
positioninteger
platform_optionsobject
first_commentstring | null
tagsarray of string
created_atstring (date-time) | null
updated_atstring (date-time) | 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/templates
curl "https://api.socialit.com/v1/templates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "object": "template",
      "id": "string",
      "name": "string",
      "alias": "string",
      "content": "string",
      "media": [
        {
          "media_id": "string",
          "type": "string",
          "url": "https://example.com",
          "thumbnail_url": "https://example.com",
          "position": 1
        }
      ],
      "platform_options": {},
      "first_comment": "string",
      "tags": [
        "string"
      ],
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}

Create a template

POST/templates

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call create-template (toolset templates)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

namestringrequired

1–200 characters

aliasstring | null

≤ 100 characters

contentstringrequired

≤ 63206 characters

media_idsarray of string

≤ 35 items

platform_optionsobject
first_commentstring | null

≤ 10000 characters

tagsarray of string

≤ 50 items

Returns object

objectstring

template

idstring
namestring
aliasstring | null
contentstring
mediaarray of object
Show 5 item attributes
media_idstring
typestring
urlstring | null
thumbnail_urlstring | null
positioninteger
platform_optionsobject
first_commentstring | null
tagsarray of string
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/templates
curl -X POST "https://api.socialit.com/v1/templates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "alias": "string",
    "content": "string",
    "media_ids": [
      "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "platform_options": {}
  }'
Response · 201
{
  "object": "template",
  "id": "string",
  "name": "string",
  "alias": "string",
  "content": "string",
  "media": [
    {
      "media_id": "string",
      "type": "string",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "position": 1
    }
  ],
  "platform_options": {},
  "first_comment": "string",
  "tags": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}

Get a template

GET/templates/{id}

Access: read

Try it with MCPAsk your agent to call get-template (toolset templates)Set up MCP

Path parameters

idstringrequired

template id (tem_…)

1–80 characters

Returns object

objectstring

template

idstring
namestring
aliasstring | null
contentstring
mediaarray of object
Show 5 item attributes
media_idstring
typestring
urlstring | null
thumbnail_urlstring | null
positioninteger
platform_optionsobject
first_commentstring | null
tagsarray of string
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/templates/{id}
curl "https://api.socialit.com/v1/templates/tem_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "template",
  "id": "string",
  "name": "string",
  "alias": "string",
  "content": "string",
  "media": [
    {
      "media_id": "string",
      "type": "string",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "position": 1
    }
  ],
  "platform_options": {},
  "first_comment": "string",
  "tags": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}

Update a template

PATCH/templates/{id}

Access: write

Try it with MCPAsk your agent to call update-template (toolset templates)Set up MCP

Path parameters

idstringrequired

template id (tem_…)

1–80 characters

Body object

namestring

1–200 characters

aliasstring | null

≤ 100 characters

contentstring

≤ 63206 characters

media_idsarray of string

≤ 35 items

platform_optionsobject
first_commentstring | null

≤ 10000 characters

tagsarray of string

≤ 50 items

Returns object

objectstring

template

idstring
namestring
aliasstring | null
contentstring
mediaarray of object
Show 5 item attributes
media_idstring
typestring
urlstring | null
thumbnail_urlstring | null
positioninteger
platform_optionsobject
first_commentstring | null
tagsarray of string
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/templates/{id}
curl -X PATCH "https://api.socialit.com/v1/templates/tem_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "alias": "string",
    "content": "string",
    "media_ids": [
      "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "platform_options": {}
  }'
Response · 200
{
  "object": "template",
  "id": "string",
  "name": "string",
  "alias": "string",
  "content": "string",
  "media": [
    {
      "media_id": "string",
      "type": "string",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "position": 1
    }
  ],
  "platform_options": {},
  "first_comment": "string",
  "tags": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}

Delete a template

DELETE/templates/{id}

Access: write

Try it with MCPAsk your agent to call delete-template (toolset templates)Set up MCP

Path parameters

idstringrequired

template id (tem_…)

1–80 characters

Returns object

objectstringrequired

template

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/templates/{id}
curl -X DELETE "https://api.socialit.com/v1/templates/tem_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "template",
  "id": "string",
  "deleted": true
}