ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

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

descriptionstring nullable

is_ads_onlyboolean

If set to true, the board will be ad-only and can store ad-only Pins.

namestring required

Name of the board.

**Note:** If you create an ad-only board by setting `is_ads_only`
to `true`, the board name automatically becomes "Ad-only Pins".

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

Example request

{
  "description": "My favorite summer recipes",
  "is_ads_only": true,
  "name": "Summer recipes"
}

Response

The request has succeeded.

board_pins_modified_atstring date-time

Date and time of last board pins modified.

collaborator_countinteger

Count of collaborators on the board.

created_atstring date-time

Date and time of board creation.

descriptionstring nullable

follower_countinteger

Board follower count.

idstring required

is_ads_onlyboolean

If set to true, the board will be ad-only and can store ad-only Pins.

namestring required

Name of the board.

**Note:** If you create an ad-only board by setting `is_ads_only`
to `true`, the board name automatically becomes "Ad-only Pins".

pin_countinteger

Count of Pins on the board.

Example response

{
  "collaborator_count": 17,
  "description": "My favorite summer recipes",
  "follower_count": 13,
  "id": "549755885175",
  "is_ads_only": true,
  "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"
    ]
  },
  "name": "Summer recipes",
  "pin_count": 5
}

Changes

Changed in 5 of the 29 revisions of this API.81021

Oct 16, 2025v514c297539b6471010See the full diff
- ▲
  added BoardPrivacy to the privacy request property allOf list
  request-property-all-of-added
- ▲
  removed the enum value PROTECTED of the request property privacy
  request-property-enum-value-removed
- ▲
  removed the enum value PUBLIC of the request property privacy
  request-property-enum-value-removed
- ▲
  removed the enum value SECRET of the request property privacy
  request-property-enum-value-removed
- ▲
  the privacy request property type/format changed from string/ to /
  request-property-type-changed
- ▲
  the privacy response's property type/format changed from string/ to / for status 201
  response-property-type-changed
- ▲
  removed the required property name from the response with the 201 status
  response-required-property-removed
- ●
  removed the optional property board_pins_modified_at from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property collaborator_count from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property created_at from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property description from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property follower_count from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property id from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property is_ads_only from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property media from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property owner from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property pin_count from the response with the 201 status
  response-optional-property-removed
- ○
  added BoardBase to the response body allOf list for the response status 201
  response-body-all-of-added
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
- ○
  added the non-success response with the status 429
  response-non-success-status-added
- ○
  added BoardPrivacy to the privacy response property allOf list for the response status 201
  response-property-all-of-added
- ○
  removed the PROTECTED enum value from the privacy response property for the response status 201
  response-property-enum-value-removed
- ○
  removed the PUBLIC enum value from the privacy response property for the response status 201
  response-property-enum-value-removed
- ○
  removed the SECRET enum value from the privacy response property for the response status 201
  response-property-enum-value-removed
- ○
  added the success response with the status 200
  response-success-status-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 16, 2025v543134ca41f182See the full diff
- ○
  added the new optional request property is_ads_only
  new-optional-request-property
- ○
  added the optional property is_ads_only to the response with the 201 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 4, 2025v510f9eba4ad971See the full diff
- ○
  the endpoint scheme security client_credentials was added to the API
  api-security-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 12, 2023v5689b4b2676397See the full diff
- ○
  added the new optional query request parameter ad_account_id
  new-optional-request-parameter
- ○
  added the optional property board_pins_modified_at to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property collaborator_count to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property created_at to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property follower_count to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property media to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property pin_count to the response with the 201 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 5, 2021v58583f6373a8011See the full diff
- ▲
  the owner response's property type/format changed from / to object/ for status 201
  response-property-type-changed
- ○
  added the non-success response with the status 400
  response-non-success-status-added

Full history