CreateConversationRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/twilio/main/json-schema/twilio-create-conversation-request-schema.json",
  "title": "CreateConversationRequest",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twilio-conversations-api-openapi.yml#/components/schemas/CreateConversationRequest",
  "type": "object",
  "properties": {
    "FriendlyName": {
      "type": "string",
      "description": "The human-readable name of this conversation, limited to 256 characters. Optional."
    },
    "UniqueName": {
      "type": "string",
      "description": "An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL."
    },
    "DateCreated": {
      "type": "string",
      "format": "date-time",
      "description": "The date that this resource was created."
    },
    "DateUpdated": {
      "type": "string",
      "format": "date-time",
      "description": "The date that this resource was last updated."
    },
    "MessagingServiceSid": {
      "type": "string",
      "minLength": 34,
      "maxLength": 34,
      "pattern": "^MG[0-9a-fA-F]{32}$",
      "description": "The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to."
    },
    "Attributes": {
      "type": "string",
      "description": "An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified.  **Note** that if the attributes are not set \"{}\" will be returned."
    },
    "State": {
      "type": "string",
      "$ref": "#/$defs/conversation_enum_state",
      "description": "Current state of this conversation. Can be either `active`, `inactive` or `closed` and defaults to `active`"
    },
    "Timers.Inactive": {
      "type": "string",
      "description": "ISO8601 duration when conversation will be switched to `inactive` state. Minimum value for this timer is 1 minute."
    },
    "Timers.Closed": {
      "type": "string",
      "description": "ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes."
    },
    "Bindings.Email.Address": {
      "type": "string",
      "description": "The default email address that will be used when sending outbound emails in this conversation."
    },
    "Bindings.Email.Name": {
      "type": "string",
      "description": "The default name that will be used when sending outbound emails in this conversation."
    }
  },
  "$defs": {
    "conversation_enum_state": {
      "type": "string",
      "enum": [
        "inactive",
        "active",
        "closed"
      ]
    }
  }
}