Skip to content
Tailwind API

Create post

POST
/v1/accounts/{accountId}/posts

Create a new post. If sendAt is provided, the post will be scheduled. Otherwise, it will be saved as a draft.

Authorizations

Parameters

Path Parameters

accountId
required
string

Pinterest account ID

Request Body required

object
mediaUrl
required

URL of the media file to pin

string format: uri
mediaType

Type of media

string
default: image
Allowed values: image video
title

Pin title

string
<= 100 characters
description

Pin description

string
<= 500 characters
url

Destination URL when pin is clicked

string format: uri
boardId

Target board ID

string
altText

Alt text for accessibility

string
<= 500 characters
sendAt

When to publish the pin. If omitted, post is saved as draft.

string format: date-time

Responses

201

Post created

object
data
object
post
object
id

Post ID

string
status

Post status

string
Allowed values: draft queued sent uploading
mediaUrl

URL of the media file

string
mediaType

Type of media

string
Allowed values: image video
title

Pin title

string
nullable
description

Pin description

string
nullable
url

Destination URL

string
nullable
boardId

Target board ID

string
nullable
altText

Alt text for accessibility

string
nullable
sendAt

Scheduled send time (Unix timestamp)

integer
nullable
sentAt

Actual send time (Unix timestamp)

integer
nullable
createdAt

Creation time (Unix timestamp)

integer
pinId

Pinterest pin ID (only present after publishing)

string
nullable
meta
object
requestId

Unique request ID for debugging

string

400

Invalid request

object
error
object
code

Error code

string
message

Error message

string
meta
object
requestId

Unique request ID for debugging

string
Example
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid request body"
  },
  "meta": {
    "requestId": "abc123"
  }
}

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