Create External SWML Handler

POST 
/resources/external_swml_handlers

Creates an External SWML Handler

Request

application/json

Body

required

namestring
Name of the External SWML Handler.
Example: My External SWML Handler
used_forstring
Used for of the External SWML Handler.
Possible values: [calling]
Default value: calling
Example: calling
primary_request_urlstringrequired
Primary request url of the External SWML Handler.
Example: https://primary.com
primary_request_methodstring
Primary request method of the External SWML Handler.
Possible values: [GET, POST]
Default value: POST
Example: GET
fallback_request_urlstring
Fallback request url of the External SWML Handler.
Example: https://fallback.com
fallback_request_methodstring
Fallback request method of the External SWML Handler.
Possible values: [GET, POST]
Default value: POST
Example: GET
status_callback_urlstring
Status callback url of the External SWML Handler.
Example: https://callback.com
status_callback_methodstring
Status callback method of the External SWML Handler.
Possible values: [GET, POST]
Default value: POST
Example: POST

Responses

201

The request has succeeded and a new resource has been created as a result.

application/json

Schema

Schema

iduuidrequired

Universal Unique Identifier.

namestringrequired
Name of the External SWML Handler.
Example: My External SWML Handler
used_forstringrequired
Used for of the External SWML Handler.
Possible values: [calling]
Example: calling
primary_request_urlstringrequired
Primary request url of the External SWML Handler.
Example: https://primary.com
primary_request_methodUrlMethodType (string)required

The method type to use for the URL

Possible values: [GET, POST]

fallback_request_urlstringrequired
Fallback request url of the External SWML Handler.
Example: https://fallback.com
fallback_request_methodUrlMethodType (string)required

The method type to use for the URL

Possible values: [GET, POST]

status_callback_urlstringrequired
Status callback url of the External SWML Handler.
Example: https://callback.com
status_callback_methodUrlMethodType (string)required

The method type to use for the URL

Possible values: [GET, POST]

Example (from schema)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "My External SWML Handler",
  "used_for": "calling",
  "primary_request_url": "https://primary.com",
  "primary_request_method": "GET",
  "fallback_request_url": "https://fallback.com",
  "fallback_request_method": "GET",
  "status_callback_url": "https://callback.com",
  "status_callback_method": "GET"
}

401

Access is unauthorized.

application/json

Schema

Schema

string

Possible values: [Unauthorized]

404

The server cannot find the requested resource.

application/json

Schema

Schema

string

Possible values: [Not Found]

422

Client error

application/json

Schema

Schema

errors

object[]

required

Array [

typestringrequired

Error type.

codestringrequired

Error code.

messagestringrequired

Error details.

attributestringrequired

Request parameter associated with this error.

urlstringrequired

Link to developer resource for this error.

]

Example (from schema)

{
  "errors": [
    {
      "type": "validation_error",
      "code": "http_url_required",
      "message": "This value must be an HTTP or HTTPS URL.",
      "attribute": "status_callback_url",
      "url": "https://developer.signalwire.com/rest/signalwire-rest/overview/error-codes/#http_url_required"
    }
  ]
}