Accounts

Endpoints related to user accounts and social media accounts.

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
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"
}

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
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
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"
    }
  ]
}
PreviousPublishingNextVideo

Last updated