Sign in
boards

Create board

Create a board owned by the "operation user_account". Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".

  • By default, the "operation user_account" is the token user_account.
post/boards

Query parameters

ad_account_idstring

Unique identifier of an ad account.

Request body

idstring
created_atstring date-time

Date and time of board creation.

board_pins_modified_atstring date-time

Date and time of last board pins modified.

namestring required
descriptionstring nullable
collaborator_countinteger

Count of collaborators on the board.

pin_countinteger

Count of pins on the board.

follower_countinteger

Board follower count.

privacy'PUBLIC' | 'PROTECTED' | 'SECRET'

Privacy setting for a board. Learn more about <a href="https://help.pinterest.com/en/article/secret-boards">secret boards</a> and <a href="https://help.pinterest.com/en/business/article/protected-boards">protected boards</a>

Example request

{
  "id": "549755885175",
  "created_at": "2020-01-01T20:10:40-00:00",
  "board_pins_modified_at": "2020-01-01T20:10:40-00:00",
  "name": "Summer Recipes",
  "description": "My favorite summer recipes",
  "collaborator_count": 17,
  "pin_count": 5,
  "follower_count": 13,
  "media": {
    "image_cover_url": "https://i.pinimg.com/400x300/fd/cd/d5/fdcdd5a6d8a80824add0d054125cd957.jpg",
    "pin_thumbnail_urls": [
      "https://i.pinimg.com/150x150/b4/57/10/b45710f1ede96af55230f4b43935c4af.jpg",
      "https://i.pinimg.com/150x150/dd/ff/46/ddff4616e39c1935cd05738794fa860e.jpg",
      "https://i.pinimg.com/150x150/84/ac/59/84ac59b670ccb5b903dace480a98930c.jpg",
      "https://i.pinimg.com/150x150/4c/54/6f/4c546f521be85e30838fb742bfff6936.jpg"
    ]
  }
}

Response

response

idstring
created_atstring date-time

Date and time of board creation.

board_pins_modified_atstring date-time

Date and time of last board pins modified.

namestring required
descriptionstring nullable
collaborator_countinteger

Count of collaborators on the board.

pin_countinteger

Count of pins on the board.

follower_countinteger

Board follower count.

privacy'PUBLIC' | 'PROTECTED' | 'SECRET'

Privacy setting for a board. Learn more about <a href="https://help.pinterest.com/en/article/secret-boards">secret boards</a> and <a href="https://help.pinterest.com/en/business/article/protected-boards">protected boards</a>

Example response

{
  "id": "549755885175",
  "created_at": "2020-01-01T20:10:40-00:00",
  "board_pins_modified_at": "2020-01-01T20:10:40-00:00",
  "name": "Summer Recipes",
  "description": "My favorite summer recipes",
  "collaborator_count": 17,
  "pin_count": 5,
  "follower_count": 13,
  "media": {
    "image_cover_url": "https://i.pinimg.com/400x300/fd/cd/d5/fdcdd5a6d8a80824add0d054125cd957.jpg",
    "pin_thumbnail_urls": [
      "https://i.pinimg.com/150x150/b4/57/10/b45710f1ede96af55230f4b43935c4af.jpg",
      "https://i.pinimg.com/150x150/dd/ff/46/ddff4616e39c1935cd05738794fa860e.jpg",
      "https://i.pinimg.com/150x150/84/ac/59/84ac59b670ccb5b903dace480a98930c.jpg",
      "https://i.pinimg.com/150x150/4c/54/6f/4c546f521be85e30838fb742bfff6936.jpg"
    ]
  }
}

Changes