Share a Data Marketplace segment with a buyer

This is an idempotent upsert: the first call creates the share and returns 201, and repeating the same call returns 200 with the existing share record, whose origin may be buyer-requested (such a share is not converted). The buyer must appear in GET /v1/buyers; sharing with an org that is not an approved partner is rejected rather than creating a relationship.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

The ID of the Data Marketplace segment to share.

string
required

LiveRamp Organization ID of the approved buyer partner to share the segment with.

Headers
string
required

The standard way for a LiveRamp API client to identify the Org it is operating as is to set the LR-Org-ID HTTP header.

string
required

Requester's access token, fetched from sso.liveramp.com. e.g. Bearer $ACCESS_TOKEN.

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json