Create a brand voice

Page last updated 12 June 2026

Endpoint for creating a new Brand Voice.

POSTapi/management/projects/{projectId}/ai/brandvoices

Parameters

Name	Parameter type	Type	Description
projectId(required)	path	string	The project identifier found in the project overview screen of the management console.
Brand Voice Request(required)	body	object	Brand Voice request model

Responses

HTTP status code	Reason	Model
201	CREATED	Brand Voice
401	Unauthorized	Error
404	Project not found	Error
409	Conflict
422	Validation error(s)	Error
500	Internal server error	Error

Examples

HTTP

POST: /api/management/projects/website/ai/brand-voice-id
{
    "name": "Contensis: Event",
    "id": "contensis-event",
    "description": "Contensis event brand voice to help keep it consistent",
    "training": {
        "text": "Text to train the model and generate a customized brand voice",
        "urls": [
            "https://www.contensis.com/community/blog/content-personalisation-101-what-it-is-why-it-matters-and-how-to-do-it-well"
        ]
    },
    "isDefaultProjectBrandVoice": false,
    "summary": "The brand voice is approachable yet knowledgeable, blending clarity with helpful authority to guide readers through complex content personalisation concepts in an encouraging and pragmatic way.",
    "tone": "conversational and informative",
    "personalityTraits": "friendly, supportive, knowledgeable, practical",
    "languageComplexity": "simple to intermediate",
    "sentenceStructure": "short to medium-length, clear and direct",
    "vocabularyChoices": "industry terminology explained clearly, approachable phrasing",
    "useOfLiteraryDevices": "occasional rhetorical questions, direct address (\"you\"), analogies, gentle reassurance",
    "uniqueCharacteristics": "breaks down complex ideas into manageable steps; reassures and motivates the reader; uses inclusive language to demystify digital concepts",
    "detectedReadingEaseScore": 38,
    "readingEaseOverride": "Difficult",
    "inclusivity": {
        "avoidCulturalOrReligiousReferences": true,
        "useGenderNeutralNounsAndPronouns": true,
        "avoidIdiomsSlangAndAcronyms": true
    },
    "termsToAvoid": "synergy"
}

Sample POST Data all properties

JSON

{
    "name": "Contensis: Event",
    "id": "contensis-event",
    "description": "Contensis event brand voice to help keep it consistent",
    "training": {
        "text": "Text to train the model and generate a customized brand voice",
        "urls": [
            "https://www.contensis.com/community/blog/content-personalisation-101-what-it-is-why-it-matters-and-how-to-do-it-well"
        ]
    },
    "isDefaultProjectBrandVoice": false,
    "summary": "The brand voice is approachable yet knowledgeable, blending clarity with helpful authority to guide readers through complex content personalisation concepts in an encouraging and pragmatic way.",
    "tone": "conversational and informative",
    "personalityTraits": "friendly, supportive, knowledgeable, practical",
    "languageComplexity": "simple to intermediate",
    "sentenceStructure": "short to medium-length, clear and direct",
    "vocabularyChoices": "industry terminology explained clearly, approachable phrasing",
    "useOfLiteraryDevices": "occasional rhetorical questions, direct address (\"you\"), analogies, gentle reassurance",
    "uniqueCharacteristics": "breaks down complex ideas into manageable steps; reassures and motivates the reader; uses inclusive language to demystify digital concepts",
    "detectedReadingEaseScore": 38,
    "readingEaseOverride": "Difficult",
    "inclusivity": {
        "avoidCulturalOrReligiousReferences": true,
        "useGenderNeutralNounsAndPronouns": true,
        "avoidIdiomsSlangAndAcronyms": true
    },
    "termsToAvoid": "synergy"
}

Sample POST required properties only

JSON

{
    "name": "Contensis: Event",
    "id": "contensis-event"
}

Remarks

You must be part of the System Administrators group or be part of the Brand Voice Create role.

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