Get account

GET

/v1/accounts/{accountId}

curl --request GET \
  --url https://api-v1.tailwind.ai/v1/accounts/example \
  --header 'Authorization: Bearer <token>'

• Production
• Development

Get a single connected Pinterest account. A 404 means the account is unknown, is not yours (the two are deliberately indistinguishable, so that account IDs cannot be enumerated), or is one of your own accounts that is no longer connected to Tailwind — the last case says so in the message.

Authorizations

• bearerAuth

Parameters

Path Parameters

accountId

required

string

Numeric Tailwind account ID returned by GET /v1/accounts

Responses

200

Account details

Media typeapplication/json

object

data

object

account

A single account. Same fields as an entry in GET /v1/accounts, plus the verified domain.

object

id

Account ID

string

userId

Pinterest user ID

string

displayName

Display name

string

nullable

username

Pinterest username

string

nullable

avatarUrl

Profile image URL

string

nullable

tokenAuthorized

Whether the Pinterest token is confirmed valid. False both when the token is revoked and when its status could not be checked; tokenStatus tells the two apart.

boolean

tokenStatus

The Pinterest token’s status. unauthorized means the account must be reconnected. unknown means Tailwind could not check the token just now, usually a temporary failure; it does not mean the account needs reconnecting, so retry later.

string

Allowed values: authorized unauthorized unknown

isDomainVerified

Whether the domain is verified

boolean

domainUrl

The account’s claimed domain. Omitted when no domain is set.

string

timezone

IANA time zone Tailwind schedules this account in, such as America/New_York — the zone its timeslots and the dashboard calendar use. Set per organization. Null when none is set.

string

nullable

createdAt

When the account was connected (Unix timestamp)

integer

nullable

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "data": {
    "account": {
      "tokenStatus": "authorized"
    }
  }
}

401

Authentication required or invalid bearer credentials

Media typeapplication/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable reason. On PAYMENT_REQUIRED errors it is the denial reason: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded. Other errors may carry an operation-specific reason, such as pinterest_reconnect_required, pinterest_rate_limited, pinterest_timeout, pinterest_request_failed or list_boards_upstream_failed; each operation’s documented error responses show the values it returns. Branch on reason rather than parsing message.

string

resolve_url

Present on PAYMENT_REQUIRED errors: where the denial can be resolved. Reason-specific, because buying credits does not clear a trial, access or connection denial. Requests sent with X-Request-Source: mcp receive an informational plans page instead, so agent surfaces never present a purchase link.

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "requestId": "abc123"
  }
}

404

Resource not found

Media typeapplication/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable reason. On PAYMENT_REQUIRED errors it is the denial reason: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded. Other errors may carry an operation-specific reason, such as pinterest_reconnect_required, pinterest_rate_limited, pinterest_timeout, pinterest_request_failed or list_boards_upstream_failed; each operation’s documented error responses show the values it returns. Branch on reason rather than parsing message.

string

resolve_url

Present on PAYMENT_REQUIRED errors: where the denial can be resolved. Reason-specific, because buying credits does not clear a trial, access or connection denial. Requests sent with X-Request-Source: mcp receive an informational plans page instead, so agent surfaces never present a purchase link.

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Account not found"
  },
  "meta": {
    "requestId": "abc123"
  }
}

429

Rate limit exceeded

Media typeapplication/json

object

error

object

code

Error code

string

message

Error message

string

reason

Machine-readable reason. On PAYMENT_REQUIRED errors it is the denial reason: insufficient_credits, trial_exhausted, no_access, account_not_connected, legacy_post_limit_exceeded. Other errors may carry an operation-specific reason, such as pinterest_reconnect_required, pinterest_rate_limited, pinterest_timeout, pinterest_request_failed or list_boards_upstream_failed; each operation’s documented error responses show the values it returns. Branch on reason rather than parsing message.

string

resolve_url

Present on PAYMENT_REQUIRED errors: where the denial can be resolved. Reason-specific, because buying credits does not clear a trial, access or connection denial. Requests sent with X-Request-Source: mcp receive an informational plans page instead, so agent surfaces never present a purchase link.

string

meta

object

requestId

Unique request ID for debugging

string

Example

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily rate limit of 10000 requests for this organization exceeded. Resets at midnight UTC."
  },
  "meta": {
    "requestId": "abc123"
  }
}

Headers

Retry-After

integer

Seconds until the daily limit resets at midnight UTC.