Create a Dialogue

POST https://app.sociable.how/api/dialogues

Before generating messages, you must first create a dialogue for the messages to exist within.

Specifically you will need the “id” property within the returned “dialogue” object. We recommend that you safely store this value so that you can easily use our message generation endpoint.

Request Parameters

Parameter	Description	Example
name	Name of the person your AI is conversing with	John Doe
dialogueType (optional)	Largely for social media-like platforms. Must be either MESSAGE or COMMENT, indicates whether the dialogue occurs in direct messages or a comments section.	MESSAGE

Sample Request Body:

{
    "name": "Suzie Tester"
}

Sample Response:

{
    "success": true,
    "dialogue": {
        "id": "9c831f86-3859-49b6-8b58-4b5425aaf131",
        "name": "Suzie Tester",
        "type": "MESSAGE",
        "enabled": true,
        "createdAt": "2024-07-31T20:40:43.707Z",
        "updatedAt": "2024-07-31T20:40:43.707Z"
    }
}