POST
/
publisher.v1
/
member
/
bulk-upsert
Bulk Upsert
curl --request POST \
  --url http://localhost/publisher.v1/member/bulk-upsert \
  --header 'Content-Type: application/json' \
  --data '
{
  "member_base_id": "<string>",
  "members": [
    {
      "ref": "<string>"
    }
  ]
}
'
[
  "<string>"
]
Upsert (create or update) members in batch. This is the primary way to sync your user base with Publisher. Members are identified by their ref — an external identifier controlled by your system. If a member with the given ref already exists in the memberbase, their record is updated. Otherwise a new member is created.

​
Idempotency

This operation is fully idempotent. Calling it multiple times with the same payload produces the same result. This makes it safe to retry on network failures without risk of duplicating members.

​
Attributes

You can optionally include attributes for each member in the upsert payload. These attributes are used for targeting and delivery rules. Any attributes not included in the payload are left unchanged for existing members.

Body

application/json
​
member_base_id
string
required
​
members
object[]
required

Response

Successful response