Create Audience

Page last updated 12 June 2026

This endpoint creates a single audience for a specified project.

POSTapi/management/projects/{projectId}/personalization/audiences/

Parameter

Name	Parameter type	Type	Description
projectId(required)	path	string	The project identifier found in the project overview screen of the management console.

Responses

HTTP status code	Reason	Model
401	Unauthorized	Error
404	Project not found	Error
422	Validation error(s)	Error
500	Internal server error	Error

Examples

Basic POST example data. Id is auto-generated

JSON

{
	"name": "My New Audience"
}

POST example where an Id is defined separately and a description is included

JSON

{
	"id": "myAudienceToUse",
	"name": "My New Audience",
	"description": "Example of a new audience"
}

Full example with conditions included

JSON

{
	"id": "myNewAudience",
	"name": "My New Audience",
	"description": "Example of a new audience",
    "conditions": {
        "and": [
            {
                "id": "testDelete",
                "type": "audience"
            },
            {
                "id": "signalTesting",
                "type": "signal"
            }
        ]
    }
}

Remarks

The only required field to create an Audience is the name field. If no id is provided one will be generated based on the name.

name and id must both be unique.

When referencing an Audience or Signal in the conditions they must already exist.

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.

New support request