social

Embed

<a href="https://hermeticor.com/docs/ref-social"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/4f753d61-6770-4878-b2fd-ce3457b68fc6/social-card.svg?v=3e7ae33eec8b" alt="social" width="600" height="315"></a>

GEThttps://hermeticor.com/v1/social/apps

Which networks (and Slack) can be connected by sign-in on this install

Parameters

limitintegerquery

Page size; omitted returns the whole list

cursorstringquery

Opaque: the nextCursor of the previous page

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/social/apps" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "provider": "linkedin",
      "configured": true
    }
  ],
  "nextCursor": "string"
}

Schema

itemsobject[]required

Show child parameters

providerstringrequired

linkedin | facebook | instagram | x | slack

configuredbooleanrequired

nextCursorstringrequired

4XX Default Response

Example

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}

Schema

errorobjectrequired

Show child parameters

codestringrequired

messagestringrequired

detailsobject

5XX Default Response

Same as 4XX · GET /v1/social/apps

GEThttps://hermeticor.com/v1/social/accounts

Connected social accounts

Parameters

limitintegerquery

Page size; omitted returns the whole list

cursorstringquery

Opaque: the nextCursor of the previous page

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/social/accounts" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "platform": "linkedin",
      "externalId": "string",
      "name": "string",
      "status": "connected",
      "lastError": "string",
      "tokenExpiresAt": "string",
      "createdAt": "string"
    }
  ],
  "nextCursor": "string"
}

Schema

itemsItemsItem246[]required

Show child parameters

idstringrequired

platformstringrequired

linkedin | facebook | instagram | x

externalIdstringrequired

namestringrequired

statusstringrequired

connected | expired | error

lastErrorstringrequired

tokenExpiresAtstringrequired

createdAtstringrequired

nextCursorstringrequired

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

POSThttps://hermeticor.com/v1/social/accounts

Connect with a pasted access token (stored encrypted); connects every page/account it can post as unless externalId is given

Request body

application/json

platformstringrequired

linkedin | facebook | instagram | x

accessTokenstringrequired

refreshTokenstring

externalIdstring

{
  "platform": "linkedin",
  "accessToken": "string",
  "refreshToken": "string",
  "externalId": "string"
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/social/accounts" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"linkedin","accessToken":"string","refreshToken":"string","externalId":"string"}'

TypeScript

Python

PHP

Ruby

Java

Responses

201 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "platform": "linkedin",
      "externalId": "string",
      "name": "string",
      "status": "connected",
      "lastError": "string",
      "tokenExpiresAt": "string",
      "createdAt": "string"
    }
  ]
}

Schema

itemsItemsItem246[]required

Show child parameters

idstringrequired

platformstringrequired

linkedin | facebook | instagram | x

externalIdstringrequired

namestringrequired

statusstringrequired

connected | expired | error

lastErrorstringrequired

tokenExpiresAtstringrequired

createdAtstringrequired

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

DELETEhttps://hermeticor.com/v1/social/accounts/{id}

Disconnect an account and delete its token

Parameters

idstringpathrequired

Code samples

cURL

curl -X DELETE "https://hermeticor.com/v1/social/accounts/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "ok": true
}

Schema

okbooleanrequired

true

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

POSThttps://hermeticor.com/v1/social/oauth/{platform}/start

Start sign-in with the network; returns its authorize URL

Parameters

platformstringpathrequired

linkedin | facebook | instagram | x

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/social/oauth/{platform}/start" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "url": "string"
}

Schema

urlstringrequired

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

GEThttps://hermeticor.com/v1/social/oauth/pending/{id}

Pages and accounts a finished sign-in can post as, to pick from (yours, for 15 minutes)

Parameters

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/social/oauth/pending/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "platform": "linkedin",
  "items": [
    {
      "externalId": "string",
      "name": "string",
      "connected": true
    }
  ]
}

Schema

platformstringrequired

linkedin | facebook | instagram | x

itemsobject[]required

Show child parameters

externalIdstringrequired

namestringrequired

connectedbooleanrequired

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

POSThttps://hermeticor.com/v1/social/oauth/pending/{id}

Connect the picked pages and accounts from a sign-in; the others are forgotten

Parameters

idstringpathrequired

Request body

application/json

externalIdsstring[]required

{
  "externalIds": [
    "string"
  ]
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/social/oauth/pending/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalIds":["string"]}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 201 · POST /v1/social/accounts

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

GEThttps://hermeticor.com/integrations/social/{platform}/callback

Parameters

typequery

additionalPropertiesstringquery

platformstringpathrequired

linkedin | facebook | instagram | x

Code samples

cURL

curl -X GET "https://hermeticor.com/integrations/social/{platform}/callback"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

"string"

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

GEThttps://hermeticor.com/v1/social/posts

Posts scheduled or published in a date range (the calendar)

Parameters

fromstringqueryrequired

tostringqueryrequired

accountIdstringquery

limitintegerquery

Page size; omitted returns the whole list

cursorstringquery

Opaque: the nextCursor of the previous page

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/social/posts?from=<from>&to=<to>" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "accountId": "string",
      "groupId": "string",
      "text": "string",
      "media": [
        {
          "url": "string",
          "type": "image"
        }
      ],
      "link": "string",
      "status": "draft",
      "scheduledAt": "string",
      "publishedAt": "string",
      "externalId": "string",
      "url": "string",
      "error": "string",
      "metrics": {},
      "metricsAt": "string",
      "createdAt": "string"
    }
  ],
  "nextCursor": "string"
}

Schema

itemsItemsItem247[]required

Show child parameters

idstringrequired

accountIdstringrequired

groupIdstringrequired

textstringrequired

mediaobject[]required

Show child parameters

urlstringrequired

typestringrequired

image | video

linkstringrequired

statusstringrequired

scheduledAtstringrequired

publishedAtstringrequired

externalIdstringrequired

urlstringrequired

errorstringrequired

metricsobjectrequired

metricsAtstringrequired

createdAtstringrequired

nextCursorstringrequired

4XX Default Response

Same as 4XX · GET /v1/social/apps

5XX Default Response

Same as 4XX · GET /v1/social/apps

Next part

Updated Nov 8, 2026

Was this page helpful?