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
Responses
200
Current user information
application/json
get
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
Query parameters
platformstring ยท enumOptional

Social media platform

Example: twitterPossible values:
Responses
200
Default Response
application/json
get
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
Path parameters
accountIdstringRequired
Responses
200
Default Response
application/json
get
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"
    }
  ]
}

Was this helpful?