Segmentation

Segmentation is an extremely useful tool used to target a specific group of customers with a dedicated campaign. Create segments based on contact properties or the contact activity (opens, clicks). Segmentation helps you focus your campaigns on specific demographics, create re-engagement campaigns, etc.

The resources below help you manage your segmentation formulas.

post

Create a new contact segmentation formula

post

/contactfilter

Create a new segmentation formula to be applied on contact lists when you send your campaigns. Segmentation can be done based on additional data saved for contacts via `/contactmetadata` and/or based on contact activity (or lack thereof).

Full API path

https://api.mailjet.com/v3/REST/contactfilter

Body parameters

Description

string

A description of the segment you can add for convenience, or to easier understand its functionality.

Expression

string

The rule, based on which the segment is calculated. Refer to our Segmentation Guide for detailed information on the syntax.

Name

string

User-selected name for this segment.

Responses

Note: You can find all the errors related to API in the error page

Count

integer

Data

array

Description

string

A description of the segment you can add for convenience, or to easier understand its functionality.

Expression

string

The rule, based on which the segment is calculated. Refer to our Segmentation Guide for detailed information on the syntax.

Name

string

User-selected name for this segment.

ID

integer

Unique numeric ID for this segment.

Status

string

Status of this segment. Indicates whether a segment was used for sending or not, or if it was deleted.

Possible values:

  • used
  • unused
  • deleted

Total

integer