This endpoint is currently in BETA.
Experiment with this API

Boards - Create Board

Boards are where you collect, curate, collaborate on and manage photo and video assets in one place. More information on the Boards FAQ. Use this endpoint to create a Board by a specific id.


You'll need an API key and a Resource Owner Grant access token to use this resource. Please see our Getting Started page for more information on how to sign up for an API key.

Use the following endpoint to create a new board:


Add API key and the Resource Owner Grant token to the request header:

Api-Key: <your api key>
Authorization: Bearer <your secure access token>

The request body should look like:

  "name": "New Board Name",
  "description": "This is a description of the board."

Your request would look like this using curl:

curl -H 'Authorization: Bearer <secure access token>' -H 'Api-Key: <your api key>' -H 'Content-Type: application/json' '' -d $'{\n  "name": "New Board",\n  "description": "New Description"\n}'

NOTE: The input to this endpoint is not sanitized in any way, so it is the responsibility of the client to ensure that it is properly formatted and guards against malicious data (for example cross-site scripting attacks or HTML injection) when accessing the data.

If successful your response will return code 201 Created and look similar to:

  "id": "hArXLENjAkmBbcjV7DJKRg"

Request Headers

Api-Key string Provide your API key. Required.
Authorization string Provide access token in the format of 'Bearer {token}'. Required.
Accept-Language string Provide a header to specify the language of result values.

Request Body Fields


name string
description string

Response Body Fields


id string Specifies a unique identifier for the board.

Response Status Codes

201 Created
400 InvalidParameterValue
400 BoardNameRequired
401 Unauthorized
403 SecureTokenRequired