Skip to main content

Page last updated 12 June 2026

This endpoint is for creating a Signal for a specific Project.
POSTapi/management/projects/{projectId}/personalization/signals

Parameter

NameParameter typeTypeDescription
projectId(required)pathstringThe project identifier found in the project overview screen of the management console.

Responses

HTTP status codeReasonModel
401UnauthorizedError
404Project not foundError
422Validation error(s)Error
500Internal server errorError

Examples

Basic create Signal
JSON
{
    "name": "Minimal Example"
}
Basic Create with minMatches
JSON
{
    "name": "Basic with min matches",
    "minMatches": 4
}
Full example
JSON
{
    "id": "signalExample",
    "name": "Signal Example",
    "description": "This is an example signal",
    "minMatches": 4,
    "where": {
        "or": [
            {
                "attribute": "browser.ScreenWidth",
                "equalTo": "1920"
            },
            {
                "attribute": "page.url",
                "startsWith": "/test"
            }
        ]
    }
}

Remarks

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

name and id must both be unique.

minMatches is used to determine the minimum number of times the actions in the where clause must be performed.

minMatches has a maximum value of 100.

When referencing a Custom Attribute in the where clause it 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