tebarDocs
GuideDevelopersAPI ReferenceChangelog
Accounts

Create a Pinterest board

POST
/v1/accounts/{id}/pinterest/boards

A public board, added to the cached board list right away.

Requires the write scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Request Body

application/json
  1. body
name*string
Length1 <= length <= 50

Response Body

The board: { id, name, privacy }.

Example Request
curl -X POST 'https://api.tebar.app/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/pinterest/boards' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string"
}'
Example Response
Empty

List Pinterest boards GET

Pinterest accounts only: boards a Pin can be saved to, [{ id, name, privacy }]. Cached 10 minutes; refresh=1 reads Pinterest again. Other accounts: 400 not_pinterest. Requires the read scope.

Get YouTube uploads left today GET

{ used, limit, user_used, user_limit, resets_at }. Past either limit, videos wait for the reset (midnight Pacific time) instead of failing. Requires the read scope.