Reach: Segments

Create a new contact segment

Changed on

Create a new contact segment.

This endpoint allows creating a new contact segment that can be used to organize contacts. The segment can be configured with specific criteria like email, name, subscription status, etc.

Deprecated. This endpoint cannot target a profile, so it always falls back to the client's default profile and cannot create segments in any other profile. Use POST /api/reach/v1/profiles/{profileUuid}/segmentation/segments instead.

post/api/reach/v1/segmentation/segments

Request

  • Base URL: https://developers.hostinger.com
  • URL: https://developers.hostinger.com/api/reach/v1/segmentation/segments
  • Auth: HTTP bearer

Request body

namestring required
logic'AND' | 'OR' required

Example request

{
  "name": "New segment name",
  "conditions": [
    {
      "operator": "equals",
      "value": "example@example.com",
      "attribute": "note"
    }
  ],
  "logic": "AND"
}

Response

Success response

uuidstring
namestring
created_atstring date-time
updated_atstring date-time

Example response

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Segment name",
  "created_at": "2025-02-27T11:54:22Z",
  "updated_at": "2025-02-27T11:54:22Z"
}

Changes

  • 796bd5194565Revision changes
    • info

      endpoint deprecated

    • info

      added the new not_soft_bounced enum value to the request property //

    • info

      added the new soft_bounced enum value to the request property //