Twilio

Send SMS text messages and read message history through the Twilio SMS REST API.

• Base URL: https://api.twilio.com/2010-04-01
• Auth: HTTP Basic — username:password is your AccountSid:AuthToken (an APIKeySID:APIKeySecret pair also works). No OAuth, no business account.
• Standard library only — no external Python packages.

Operations

The Account SID is taken from the part of apiKey before the colon and used as the /Accounts/{AccountSid}/ path segment, so a single apiKey value carries both the credential and the routing account.

apiKey setup

1. Sign in to the Twilio Console.
2. On the dashboard, copy your Account SID (starts with AC...) and your Auth Token.
3. Set apiKey to the two joined with a colon: ACxxxxxxxx...:your_auth_token.

For finer-grained access you can instead create an API Key (Console → Account → API keys & tokens). Use APIKeySID:APIKeySecret, but still pass the Account SID as the routing account by formatting apiKey as AccountSid:APIKeySecret when the key SID and account differ.

Examples

Send an SMS

operation: send
apiKey:    ACxxxxxxxxxxxxxxxx:your_auth_token
to:        +15558675310
from:      +15017122661
body:      Your InTouch job finished successfully.

Returns the created message resource (including sid, status, price).

List the last 5 messages

operation: list
apiKey:    ACxxxxxxxxxxxxxxxx:your_auth_token
pageSize:  5

Returns { "messages": [ ... ] }.

Output

Both publish:

• result — the Twilio response body as a JSON string.
• status — the HTTP status code (e.g. 201 for a successful send, 200 for reads).

On any error the step prints {"error": "..."} and exits non-zero, marking the YAML step FAILED.

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.