Pins

Create Pins Batch

Create and publish several pins in one call.

Each entry is processed independently and reported with its own outcome (created, existing for an idempotency-key hit, or failed with an error envelope). Requires the bulk publishing plan feature and enough monthly quota for every entry that would be created. Quota headers describe the workspace; Pinterest rate headers are only included when every entry targets one account.

post/v1/pins/batch

Request

  • Base URL: https://api.pinbridge.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.pinbridge.io/v1/pins/batch
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

x-api-keystring nullable
authorizationstring nullable

Request body

Response

Successful Response

created_countinteger required
existing_countinteger required
failed_countinteger required
headroomobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.