MessageBird API
handlers public
15
Node
JavaScript
Python beta
Ruby beta
Shell
curl
The handlers API requires you to accept the latest Terms of Service (ToS) in order to use it.

Please click here to accept.
We hope you enjoy documentation for the MessageBird handlers API on StdLib! This API can be used via the command line (shell), Node, Ruby, Python or as a generic HTTP call in any language. Check the code examples on the right associated with each API method for how to use this API in your language of choice.
API Description
Set StdLib functions as handlers for previously claimed MessageBird telephone numbers
Sets a handler for incoming SMS messages for a phone number you own. Should be used after first initializing a phone number from the "numbers" API.
Authenticated   |   Pricing  ·  Free   |   Limit  ·  no rate limit
Unauthenticated   |   Forbidden  ·  Requires ToS
Parameters
number
required
string
The phone number you would like to set a handler for, you must own the number to set a handler. Check the numbers.list API to ensure you own the number.
current value set to
enter a test value
identifier
required
string
The service identifier for a StdLib function you would like to run in response to a received text message. For example, if your username is "user", your service is "service", the published environment is "dev", and the function is "method", your identifier is "user.service[@dev].method".
current value set to
enter a test value
Unsets (removes) a handler for incoming SMS messages for a phone number you own. This number should previously have been assigned a handler with the "handlers.sms.set" method.
Authenticated   |   Pricing  ·  Free   |   Limit  ·  no rate limit
Unauthenticated   |   Forbidden  ·  Requires ToS
Parameters
number
required
string
The phone number you previously assigned a handler to
current value set to
enter a test value
Made with by the MessageBird team with the help of StdLib.