Create a new Service for the given Account

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://twilio.demo.bump-doc.com/doc/intelligence/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
"intelligence MCP server": {
  "url": "https://twilio.demo.bump-doc.com/doc/intelligence/mcp"
}
Close
POST /v2/Services

Create a new Service for the given Account

application/x-www-form-urlencoded

Body

  • UniqueName string Required

    Provides a unique and addressable name to be assigned to this Service, assigned by the developer, to be optionally used in addition to SID.

  • AutoTranscribe boolean

    Instructs the Speech Recognition service to automatically transcribe all recordings made on the account.

  • DataLogging boolean

    Data logging allows Twilio to improve the quality of the speech recognition & language understanding services through using customer data to refine, fine tune and evaluate machine learning models. Note: Data logging cannot be activated via API, only via www.twilio.com, as it requires additional consent.

  • FriendlyName string

    A human readable description of this resource, up to 64 characters.

  • LanguageCode string

    The language code set during Service creation determines the Transcription language for all call recordings processed by that Service. The default is en-US if no language code is set. A Service can only support one language code, and it cannot be updated once it's set.

  • AutoRedaction boolean

    Instructs the Speech Recognition service to automatically redact PII from all transcripts made on this service.

  • MediaRedaction boolean

    Instructs the Speech Recognition service to automatically redact PII from all transcripts media made on this service. The auto_redaction flag must be enabled, results in error otherwise.

  • WebhookUrl string

    The URL Twilio will request when executing the Webhook.

  • WebhookHttpMethod string

    The HTTP method for the Webhook. One of GET or POST.

    Values are GET, POST, or NULL.

Responses

  • 201 application/json

    Created

    Hide headers attributes Show headers attributes
    • ETag string
    • X-Rate-Limit-Limit string
    • X-Rate-Limit-Remaining string
    • X-Rate-Limit-Config string
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • account_sid string | null

      The unique SID identifier of the Account the Service belongs to.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • auto_redaction boolean | null

      Instructs the Speech Recognition service to automatically redact PII from all transcripts made on this service.

    • media_redaction boolean | null

      Instructs the Speech Recognition service to automatically redact PII from all transcripts media made on this service. The auto_redaction flag must be enabled, results in error otherwise.

    • auto_transcribe boolean | null

      Instructs the Speech Recognition service to automatically transcribe all recordings made on the account.

    • data_logging boolean | null

      Data logging allows Twilio to improve the quality of the speech recognition & language understanding services through using customer data to refine, fine tune and evaluate machine learning models. Note: Data logging cannot be activated via API, only via www.twilio.com, as it requires additional consent.

    • date_created string(date-time) | null

      The date that this Service was created, given in ISO 8601 format.

    • date_updated string(date-time) | null

      The date that this Service was updated, given in ISO 8601 format.

    • friendly_name string | null

      A human readable description of this resource, up to 64 characters.

    • language_code string | null

      The language code set during Service creation determines the Transcription language for all call recordings processed by that Service. The default is en-US if no language code is set. A Service can only support one language code, and it cannot be updated once it's set.

    • sid string | null

      A 34 character string that uniquely identifies this Service.

    • unique_name string | null

      Provides a unique and addressable name to be assigned to this Service, assigned by the developer, to be optionally used in addition to SID.

    • url string(uri) | null

      The URL of this resource.

    • webhook_url string | null

      The URL Twilio will request when executing the Webhook.

    • webhook_http_method string

      The HTTP method for the Webhook. One of GET or POST.

      Values are GET, POST, or NULL.

    • read_only_attached_operator_sids array[string] | null

      Operator sids attached to this service, read only

      Minimum length of each is 34, maximum length of each is 34. Format of each should match the following pattern: ^LY[0-9a-fA-F]{32}$.

    • version integer

      The version number of this Service.

      Default value is 0.

POST /v2/Services
curl \
 --request POST 'https://intelligence.twilio.com/v2/Services' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'UniqueName=something&FriendlyName=some+friendly+name&LanguageCode=en-US&WebhookUrl=https%3A%2F%2Fwww.twilio.com&WebhookHttpMethod=POST'
Request example
{"UniqueName" => "something", "FriendlyName" => "some friendly name", "LanguageCode" => "en-US", "WebhookUrl" => "https://www.twilio.com", "WebhookHttpMethod" => "POST"}
Response examples (201)
{
  "sid": "GAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "unique_name": "something",
  "friendly_name": "some friendly name",
  "date_created": "2010-08-31T20:36:28Z",
  "date_updated": "2010-08-31T20:36:28Z",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "auto_redaction": false,
  "media_redaction": false,
  "auto_transcribe": true,
  "data_logging": true,
  "language_code": "en-US",
  "webhook_url": "https://www.twilio.com",
  "webhook_http_method": "POST",
  "read_only_attached_operator_sids": [
    "LYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  ],
  "version": 1,
  "url": "https://intelligence.twilio.com/v2/Services/GAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}