Accounts (Delivered)

Once a bundle is accepted and the account manager creates the social media account, it becomes a saved account (also called a delivered account). These accounts contain full credentials and are available for you to manage.

Accounts are read-only via the API. You can list them, view their details and credentials, and retrieve verification codes, but you cannot modify account data through the API.

List Accounts

GET /accounts

Returns a paginated list of your delivered accounts. Use query parameters to filter results.

Parameter	Type	Description
platform	string	Filter by platform: tiktok, instagram, or youtube.
country	string	Filter by country code (ISO 3166-1 alpha-2, e.g., US, FR, DE).
page	integer	Page number (default: 1).
per_page	integer	Results per page (default: 20, max: 100).

curl -X GET "https://app.tokportal.com/api/ext/accounts?platform=tiktok&country=US&page=1&per_page=20" \
  -H "X-API-Key: tok_live_xxx"

Response:

{
  "data": [
    {
      "id": "acc_abc123",
      "platform": "tiktok",
      "username": "coolcreator99",
      "country": "US",
      "status": "active",
      "created_at": "2026-01-10T08:00:00Z"
    },
    {
      "id": "acc_def456",
      "platform": "tiktok",
      "username": "trendwatcher22",
      "country": "US",
      "status": "active",
      "created_at": "2026-01-12T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 2,
    "total_pages": 1
  }
}

Get Account Details

GET /accounts/:id

Returns full account details including credentials.

curl -X GET https://app.tokportal.com/api/ext/accounts/acc_abc123 \
  -H "X-API-Key: tok_live_xxx"

Response:

{
  "data": {
    "id": "acc_abc123",
    "platform": "tiktok",
    "username": "coolcreator99",
    "country": "US",
    "status": "active",
    "created_at": "2026-01-10T08:00:00Z",
    "tokmail_email": "coolcreator99@tokmail.io",
    "password": "xK9#mP2$vL7nQ4w",
    "social_credentials": {
      "email": "coolcreator99@tokmail.io",
      "password": "Tr3nd!Set_42x"
    },
    "bundle_id": "bundle_abc123",
    "profile_picture_url": "https://your-storage.supabase.co/storage/v1/object/public/images/pfp-abc123.jpg",
    "bio": "Lifestyle & trends | DM for collabs"
  }
}

Credential Fields

Field	Description
tokmail_email	The TokMail email address assigned to this account. Used for platform sign-up and verification.
password	The TokMail inbox password.
social_credentials.email	The email used to register the social media account.
social_credentials.password	The password for the social media account itself.

Retrieve Verification Code

POST /accounts/:id/verification-code

Retrieves the most recent 6-digit verification code from the account's TokMail inbox.

How it works:

1. Trigger a verification code from the platform (e.g., request a login code from TikTok or Instagram).
2. Wait a few seconds for the email to arrive.
3. Call this endpoint to retrieve the code from the TokMail inbox.

The endpoint scans recent emails in the TokMail inbox and extracts the 6-digit code.

curl -X POST https://app.tokportal.com/api/ext/accounts/acc_abc123/verification-code \
  -H "X-API-Key: tok_live_xxx"

Response:

{
  "data": {
    "code": "482937",
    "received_at": "2026-02-11T14:05:22Z",
    "from": "noreply@tiktok.com",
    "subject": "Your verification code"
  }
}

Error — no code found:

{
  "error": {
    "code": "VERIFICATION_CODE_NOT_FOUND",
    "message": "No verification code found in the inbox. Make sure you triggered the code from the platform first and wait a few seconds before retrying."
  }
}

Tip: If you receive a VERIFICATION_CODE_NOT_FOUND error, wait 5-10 seconds and retry. Email delivery can take a moment.