Skip to main content
POST
Add, change or remove products

Authorizations

Authorization
string
header
required

Your API key, e.g. sk_live_... or sk_test_....

Headers

Idempotency-Key
string

Optional. Makes this write safe to retry: the same key replays the first response instead of acting twice.

Maximum string length: 255

Query Parameters

connection_uuid
string<uuid>
phone_number_id
string

Body

application/json
items
object[]
required
Required array length: 1 - 5000 elements
connection_uuid
string<uuid>
phone_number_id
string

Response

Queued.

One change to the catalog, sent to Meta in the background.

id
string<uuid>
catalog_id
string
source
enum<string>
Available options:
console,
csv,
api
status
enum<string>
Available options:
queued,
processing,
finished,
finished_with_errors,
failed
status_label
string
Example:

"Done, some rows need fixing"

filename
string | null
total_rows
integer
skipped_rows
integer

Rows refused before reaching Meta.

error_count
integer
errors
object[]
failure_message
string | null
created_at
string<date-time> | null
finished_at
string<date-time> | null