APappdirect
SegmentFolders

Create or remove segment-company associations

Changed on

Creates or removes associations between segments and companies

post/channel/v1/segments/{companySegmentId}/associationsBatchUpdate

Request

Path parameters

companySegmentIdstring required

Segment ID

Request body

deleteAllboolean required

Set to true to delete all associations

companyIdsToAddstring[] required

The list of company IDs to associate with the segment, up to a maximum of 1000 IDs

companyIdsToRemovestring[] required

The list of company IDs to disassociate from the segment, up to a maximum of 1000 IDs

Example request

{
  "deleteAll": "false",
  "companyIdsToAdd": [
    "7e3b3bb8-1b75-408b-8cbf-561ccd910479"
  ],
  "companyIdsToRemove": [
    "7e3b3bb8-1b75-408b-8cbf-561ccd910478"
  ]
}

Response

The segment to company associations were successfully updated.

Changes