Accounts

Endpoints related to user accounts and social media accounts.

List LinkedIn pages

get

Lists the organization pages the connected LinkedIn account can administer, so the user can choose which to add as posting targets.

Authorizations

blotato-api-keystringRequired

Query parameters

accountIdstringRequired

Blotato account id, returned from /users/me/accounts.

Responses

200

Default Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

422

Default Response

application/json

500

Server error

application/json

get/v2/integrations/oauth2/linkedin/pages

GET /v2/integrations/oauth2/linkedin/pages?accountId=text HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "isActive": true
    }
  ]
}

List Pinterest boards

get

Lists boards owned by a connected Pinterest account. Returns the id and name of each board so callers can pick the boardId required when creating a Pinterest pin via blotato_create_post.

Authorizations

blotato-api-keystringRequired

Query parameters

accountIdstringRequired

Blotato Pinterest account id, returned from /users/me/accounts.

Responses

200

Default Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

422

Default Response

application/json

500

Server error

application/json

get/v2/social/pinterest/boards

GET /v2/social/pinterest/boards?accountId=text HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": "1234567890123456789",
      "name": "Summer Outfits"
    }
  ]
}

Get current user information

get

Fetches the current user's information, including subscription status and API key if available.

Authorizations

blotato-api-keystringRequired

Responses

200

Current user information

application/json

Current user information

idstringRequired

subscriptionStatusstring · nullableRequired

apiKeystring · nullableRequired

subscriptionPlanstring · enumRequiredPossible values:

401

Unauthorized

application/json

403

Forbidden

application/json

get/v2/users/me

GET /v2/users/me HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "id": "user_12345",
  "subscriptionStatus": "active",
  "apiKey": "your-api-key",
  "subscriptionPlan": "creator"
}

Get current user accounts

get

Fetches the current user's social media accounts. Optionally filter by platform.

Authorizations

blotato-api-keystringRequired

Query parameters

platformstring · enumOptional

Social media platform

Example: twitterPossible values:

Responses

200

Default Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Server error

application/json

get/v2/users/me/accounts

GET /v2/users/me/accounts HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    [
      {
        "id": "12345",
        "platform": "twitter",
        "fullname": "John Doe",
        "username": "@johndoe"
      }
    ]
  ]
}

Get current user subaccounts

get

Fetches the current user's subaccounts for a specific account. Subaccounts are typically used for platforms like Facebook where a user can have multiple pages.

Authorizations

blotato-api-keystringRequired

Path parameters

accountIdstringRequired

Responses

200

Default Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Server error

application/json

get/v2/users/me/accounts/{accountId}/subaccounts

GET /v2/users/me/accounts/{accountId}/subaccounts HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": "facebook_page_12345",
      "accountId": "account_67890",
      "name": "My Facebook Page"
    }
  ]
}