Skip to content
Tailwind API

List timeslots

GET
/v1/accounts/{accountId}/timeslots

List all smart schedule timeslots for an account.

Authorizations

Parameters

Path Parameters

accountId
required
string

Pinterest account ID

Responses

200

List of timeslots

object
data
object
timeslots
Array<object>
object
id

Timeslot ID

string
accountId

Account ID

string
dayPreference

Day of week (0-6, where 0 is Sunday)

integer
<= 6
timePreference

Time in HH:MM format

string
timezone

Timezone (e.g., America/New_York)

string
type

Timeslot type

string
Allowed values: interval optimal
sendAt

Unix timestamp of next scheduled send

integer
meta
object
requestId

Unique request ID for debugging

string

401

Authentication required or invalid API key

object
error
object
code

Error code

string
message

Error message

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

object
error
object
code

Error code

string
message

Error message

string
meta
object
requestId

Unique request ID for debugging

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