Purpose
Purpose
- Notify an on-call responder about a security incident.
- Send a time-sensitive investigation update.
- Ask a user to review suspicious activity.
Supported Versions
Supported Versions
Authentication
Authentication
Role-based access considerations
Role-based access considerations
Pre-requisites
A paid (upgraded) Twilio account with messaging enabled and sufficient balance to send notifications.Twilio Console access to manage API credentials and Messaging Services.A Messaging Service containing at least one sender suitable for the destination country.
Setup Steps
Obtain the Account SID
- Sign in to the Twilio Console.
- Select the account or subaccount that will send messages.
- Open its home page or account dashboard.
- On the Console Home page, locate the card named after the selected account and copy its Account SID, which begins with
AC. In the legacy Console, this information appears under Account Info.
Obtain the Username and Password
Option A: Create a Standard API Key
(or)
Option B: Use the Account SID and Auth Token
Option A: Create a Standard API Key
- In the Twilio Console, open Settings → Account settings → API keys & auth tokens.
- Select the appropriate Region. For example:
United States (US1) - Click Create API key.
- Enter an API key name, such as
AirMDR-SMS-Production. - Select Standard as the key type.
- Click Next.
- Copy the generated API Key SID and Secret.
- Store the Secret securely before leaving the page.
- Select Got it!, then click Finish.
- Open Admin → Account management → Keys & credentials → API keys & tokens.
- Click Create API key.
- Enter a Friendly name.
- Select the Region and Standard key type.
- Click Create.
- Click Done.
Option B: Use the Account SID and Auth Token
- Open the selected account’s Twilio Console home page.
- Navigate to Settings → Account settings → API keys & auth tokens.
- Select the Auth tokens tab, and locate Primary auth token.
- Click the eye icon to reveal and copy the Auth Token.
Obtain the Messaging Service SID
Option A: Use an Existing Messaging Service
(or)
Option B: Create a Messaging Service
Option A: Use an Existing Messaging Service
- In the current Twilio Console, open Communications → Messaging → Services. In the legacy Console, open Messaging → Services.
- Select the service AirMDR should use.
- Open Properties.
- Copy the Messaging Service SID, which begins with
MG. - Open Sender Pool and verify that the service contains a sender that can reach your intended recipients. If it does not, click Add Senders and add a phone number, short code, or supported alphanumeric sender ID.
When sending to US recipients from a US 10DLC number, ensure that the number belongs to the selected Messaging Service and is associated with an approved A2P 10DLC campaign.
Option B: Create a Messaging Service
If an appropriate service does not exist:- Open Communications → Messaging → Services, or Messaging → Services in the legacy Console.
- Click Create a Messaging Service.
- Enter a descriptive name, such as
AirMDR Security Notifications. - Select the messaging use case appropriate for your notifications.
- Continue through the setup wizard.
- Add an eligible sender to the Sender Pool.
- Complete any applicable sender registration or verification requirements.
- Open the created service and copy its Messaging Service SID.
Twilio Credential Reference Table
Configure Twilio in AirMDR Integrations Dashboard
- Navigate to AirMDR, provide the credentials and click Login
- Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select ADMIN → Integrations.
- Use the search option, enter the keyword “Twilio”, select the Connections tab, and click + New Connection button.
-
Use the following values in the AirMDR integration configuration screen:
Expand Advanced Configuration if required. (Optional)
- In Remote Agent, select an AirMDR Remote Agent when Twilio requests must run through an approved network route. Ensure the selected agent can resolve and reach both
api.twilio.comfor sending messages andmessaging.twilio.comfor connection verification over HTTPS on TCP port443. For direct connectivity from AirMDR, leave this field unselected. - In Expiry, select a date according to your organization’s credential rotation policy, or an earlier date if the configured Twilio credentials will become invalid sooner.
Expiry controls credential validity in AirMDR. It does not automatically rotate, extend, or revoke credentials in Twilio. For API key rotation, create a replacement key, update Username with its API Key SID, Password with its Secret, and Expiry with the revised date. Save and validate the connection, then delete the previous key when it is no longer required. If using an Account SID and Auth Token, coordinate token rotation with other applications that use the same token. - In Remote Agent, select an AirMDR Remote Agent when Twilio requests must run through an approved network route. Ensure the selected agent can resolve and reach both
- Click Save.
Skills provided by this Integration & Permissions required
Messaging — Outbound Actionsaccepted or queued status confirms that Twilio accepted the request. It does not confirm delivery to the recipient.Skill Inputs
Skill Inputs
application/x-www-form-urlencoded encoding. A successful message creation returns HTTP 201 and a Twilio Message resource.Send a Test SMS (Optional)
Send a Test SMS (Optional)
- Review the account, credential pair, and Messaging Service SID.
- Click Save.
- Open the Skills tab.
- Locate Send Twilio Text Message and click Run skill.
- Select the connection if prompted.
- Enter the recipient phone number in international E.164 format, such as
+14155550123, and enter a short test message. - Run the skill once.
- Record the returned Message SID and status.
- Confirm the message’s final delivery status in Twilio.
+, the country code, and the subscriber number without spaces or punctuation.Validate Connectivity
Validate Connectivity
GET https://messaging.twilio.com/v1/Services/{MessagingServiceSID}It checks that the returned account_sid matches the Account SID saved in the connection.This verification reads the service configuration and does not send an SMS. Successful verification confirms access to the service and account ownership; it does not confirm delivery to a particular recipient.Sample Request (Send a Test SMS — Optional)
Sample Request (Send a Test SMS — Optional)
TWILIO_USERNAME is the API Key SID and TWILIO_PASSWORD is its Secret. The Account SID remains a separate value in the URL. This request creates a real outbound SMS.Sample Response
Sample Response
accepted confirms that Twilio received the request. Delivery and pricing information may become available later. Review the Message SID in Twilio’s Messaging Logs for the latest status.Additional Information
🧰 Error Handling
🧰 Error Handling
🔄 Monitoring & Logs
🔄 Monitoring & Logs
- Open the result of the skill execution or the playbook step that ran it.
- Review the returned Message SID and status.
- Record any Twilio error code and error message.
- Use the Message SID to correlate the execution with Twilio’s logs.
- Sign in to the sending account in the Twilio Console.
- Open Monitor → Logs → Messaging.
- Search for the Message SID or filter by recipient and time.
- Click the message’s linked date to open its details.
- Review the delivery steps, status, sender, recipient, and errors. See Twilio Messaging Logs.
🛑 Security & Access Best Practices
🛑 Security & Access Best Practices
👉 Support & Maintenance
👉 Support & Maintenance
- 📧 Contact AirMDR Support through your designated support channel.
- 🔁 Rotate credentials regularly. Recommended cadence: As per your internal security policy.
- Rotate API Credentials
- Create a replacement Standard API key in the same Twilio account using United States (US1).
- Update the AirMDR connection’s Username and Password.
- Save the connection.
- Run one controlled validation.
- Confirm that the new credential works.
- Delete the previous API key in Twilio after confirming that it is no longer required.
Deleting an API key revokes its access. - Maintain the Integration
- Review the connection’s Expiry date and credential renewal schedule.
- Confirm that the Messaging Service retains an eligible sender.
- Review destination permissions, account balance, and sender registration status.
- Monitor failed messages, delivery delays, and unexpected usage.
- Revalidate the connection after changing credentials, the Messaging Service, or the Remote Agent.
- Review dependent playbooks before retiring a connection.
- To revoke a dedicated API key, open Settings → Account settings → API keys & auth tokens, select the key, and click Delete this key after confirming that it is no longer required.
🛑 Data Flow & Security
🛑 Data Flow & Security
👉 Message Limits and Queueing
👉 Message Limits and Queueing
ValidityPeriod is separate from the Expiry field on the AirMDR connection. Connection Expiry does not set the SMS queue lifetime.
