ReferenceCampaigns API
Update a segment
PATCH
Send only the fields that change. name up to 200 characters. description up to 2000 characters. segmentId is the id from create.
bearerheader
AuthorizationBearer <token>Key issued in Settings → Developer → API key. Inbox methods need the Inbox scope. Campaigns methods need the Campaigns scope.
segmentId*stringSegment id returned by create or list.
application/json- body
name?stringNew name, up to 200 characters. Send only the fields that change.
description?stringNew note, up to 2000 characters.
application/json- response
id*stringSegment id.
name*stringSegment name, up to 200 characters.
description*|Optional note, up to 2000 characters, or null when none was stored.
memberCount*numberHow many people are in the segment.
createdAt*stringWhen the segment was created.
Format
date-timeupdatedAt*stringWhen the segment was last updated.
Format
date-timecurl -X PATCH 'https://api.1msg.io/api/v1/campaigns/segments/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "cm3segment01", "name": "April buyers", "description": "string", "memberCount": 12, "createdAt": "2026-11-01T09:00:00.000Z", "updatedAt": "2026-11-01T09:00:00.000Z"}