Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
twilio avatar

Twilio Security Compliance Hipaa

  • 91 installs
  • 26 repo stars
  • Updated July 29, 2026
  • twilio/ai

How to configure Twilio for HIPAA compliance: execute BAA, designate HIPAA projects, restrict to eligible services (Voice, SMS, Verify SMS/Voice/Push, Conversations, Flex, Segment, Runtime, Data), implement per-product c

About

HIPAA compliance on Twilio requires shared responsibility: execute a Business Associate Addendum, designate HIPAA projects (self-service or support ticket), use only eligible services, and follow per-product requirements. Key restrictions: WhatsApp, SendGrid Email, AI Assistants, and Verify Fraud Guard are ineligible. Voice and SMS require HTTP auth for recordings/MMS; SMS needs message redaction. Flex demands PII redaction in TaskRouter attributes and session timeout. Subaccounts must be individually flagged; inheritance applies only to new accounts created after designation. Non-US area codes prohibited. Never include PHI in support tickets or custom message tags.

  • Execute BAA before PHI touches infrastructure; designate HIPAA Project via Console or support
  • WhatsApp, SendGrid Email, AI Assistants, Verify Fraud Guard are NOT eligible for any use case
  • Voice/SMS require HTTP auth for recording/MMS URLs; message redaction recommended but incompatible with Studio/Flex/Conv
  • Flex must implement session timeout, redact TaskRouter attributes, disable WhatsApp/Facebook/Email channels
  • US area codes only; subaccounts require individual flagging; Event Streams require HIPAA-compliant sink (e.g., AWS Kines

Twilio Security Compliance Hipaa by the numbers

  • 91 all-time installs (skills.sh)
  • +11 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #1,044 of 2,203 Security skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/twilio/ai --skill twilio-security-compliance-hipaa

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs91
repo stars26
Last updatedJuly 29, 2026
Repositorytwilio/ai

What it does

Configure Twilio for HIPAA compliance in healthcare workflows: execute BAA, designate HIPAA projects, select eligible services, implement per-product requirements (Voice, SMS, Verify, Flex,

Who is it for?

Healthcare developers, HIPAA-regulated SaaS platforms, telemedicine, patient engagement, clinical workflows requiring compliant voice/SMS communication.

Skip if: Non-regulated industries, builders without legal/compliance oversight, projects requiring WhatsApp or email communication with PHI.

When should I use this skill?

Starting healthcare product on Twilio, configuring account for regulated workflows, implementing HIPAA-eligible services, troubleshooting compliance violations, migrating to Flex 3.x.x.

What you get

A fully HIPAA-compliant Twilio account with designated projects, enabled HTTP auth, message redaction where applicable, PII masking in Flex, and documented service restrictions—ready to process PHI in healthcare workflow

Files

SKILL.mdMarkdownGitHub ↗

Overview

HIPAA compliance on Twilio is a shared responsibility — Twilio provides eligible services and configuration tools, but your application must architect correctly. Getting this wrong means PHI exposure and compliance violations.

Sequence: Execute BAA → Designate HIPAA Project(s) → Use only eligible services → Follow per-product requirements

---

Step 1: Execute a BAA

  • Contact your Twilio Account Representative to execute a Business Associate Addendum
  • Purchase a Twilio Editions package that includes HIPAA Accounts
  • BAA is required before any PHI touches Twilio infrastructure

---

Step 2: Designate HIPAA Project(s)

Self-Service (BAA initiated after June 6, 2024)

1. Create an Organization in Twilio Console 2. Link accounts/projects/subaccounts to the Organization 3. Console → Twilio Admin → Accounts → Select account → Enable HIPAA flag 4. Save

Support Ticket (BAA initiated before June 6, 2024)

Open a Support ticket through Console to request HIPAA designation for specific accounts/projects/subaccounts.

Subaccount Behavior

  • Existing subaccounts are NOT auto-designated — Must be individually flagged
  • New subaccounts created AFTER designation DO auto-inherit HIPAA status
  • Verify each subaccount's HIPAA flag — don't assume inheritance

What Changes When HIPAA Is Enabled

  • Console auto-logoff after 15 minutes of inactivity
  • Account exempt from certain content moderation (but still subject to carrier complaint review)
  • No PHI in support tickets — use SIDs (CallSid, MessageSid) instead of phone numbers

---

HIPAA Eligible Services

Eligible (use these for PHI workflows)

CategoryServices
VoiceProgrammable Voice, Recordings, Transcription, Media Streams, ConversationRelay, Conversational Intelligence for Voice, SIP Interface, Elastic SIP Trunking*, Voice Insights, AMD, <Pay>, Conference, Coaching, Transfers
SMSProgrammable SMS, MMS, Long Codes, Toll-Free, Short Codes, Messaging Services (opt-out, fallback, geomatch, sticky sender, scheduling, link shortening)
IdentityVerify (SMS + Voice + Push only), Lookup
ConversationsChat, SMS, MMS, Group Texting (NOT WhatsApp)
FlexVoice, SMS, Chat, Conversations, Webchat 3.x.x, TaskRouter, Proxy, Flex Insights
SegmentConnections (Sources, Destinations, Functions), Reverse ETL, Unify, Engage Foundations, Protocols, Privacy Portal*
RuntimeStudio, Functions, Debugger, API Explorer, Sync, Private Assets, TwiML Bin*
DataEvent Streams

Items marked with require additional configuration per "Architecting for HIPAA on Twilio" guidance.*

NOT Eligible (do NOT use for PHI)

  • WhatsApp — Meta does not offer a BAA
  • SendGrid Email (including Email in Flex and Verify Email channel)
  • AI Assistants (including Voice for AI Assistants)
  • Verify Fraud Guard
  • Conversational Intelligence for Conversations (only Voice channel is eligible)
  • Agent Copilot, Unified Profiles in Flex
  • Engage Premier, Generative Audiences, Campaigns
  • Twilio Marketplace add-ons — even with third-party BAA
  • Autopilot
  • Flex Webchat 2.x.x (must migrate to 3.x.x)

Geographic restriction: Only US area codes for Voice and SMS HIPAA traffic.

---

Per-Product Requirements

Voice & Recordings

  • HTTP auth required for recording URLs — Enable in Console → Voice Settings. Recording URLs are public by default.
  • Voice Recording Encryption recommended — Encrypts with your public key before cloud storage
  • ConversationRelay: Your AI Provider must have their own BAA. Cannot use for clinical/medical decision-making.
  • Conversation Intelligence for Voice: Only Azure OpenAI for generative operators. No PHI in operator prompts. Data use auto-disabled for HIPAA accounts. PII Redaction recommended (auto-redacts 21 PHI field types).

SMS & MMS

  • HTTP auth required for MMS Media URLs — Enable in Console → Messaging → Settings → General
  • Message Redaction recommended — Redacts message bodies and phone numbers from Console/API/support
  • No PHI in Message Tags — custom attributes in Message Tagging must not contain PHI
  • Message Redaction prerequisites:

1. Disable Sticky Sender and Fallback to Long Code on Messaging Services 2. Contact Support to disable built-in STOP filtering (then implement custom STOP handling) 3. Set all webhooks to POST (GET logs params for 7 days, defeating redaction) 4. Incompatible with Studio, Flex, and Conversations

Verify

  • Only SMS, Voice, and Push channels — Email channel is NOT eligible
  • Fraud Guard is NOT eligible — do not enable for HIPAA workflows

Flex

  • Flex Insights: Twilio auto-redacts PII from TaskRouter attributes (names, phone, email). Visual waveform and speech metrics disabled.
  • Customer must: Ensure no PHI in preserved Attribute fields, Comments, or Assessments. Implement session timeout (Flex has no built-in timeout). Secure Flex Plugins for HIPAA.
  • No WhatsApp, Facebook Messenger, or SendGrid Email in Flex HIPAA workflows

Event Streams

  • Customer responsible for HIPAA-compliant sink configuration (e.g., AWS Kinesis requires Amazon's HIPAA architecture)
  • Non-eligible product event types must not process PHI

---

CANNOT

  • Cannot use WhatsApp for HIPAA workflows — Meta does not offer a BAA. Applies to all Twilio products (Conversations, Flex, Frontline).
  • Cannot use SendGrid Email — Not HIPAA eligible in any context (Verify, Flex, standalone).
  • Cannot use Verify Fraud Guard or Email channel — Not eligible. Only SMS, Voice, Push.
  • Cannot use AI Assistants — Even with ConversationRelay, AI Assistants integration is not eligible.
  • Cannot use non-US area codes — Voice and SMS HIPAA traffic limited to US area codes.
  • Cannot put PHI in support tickets — Use SIDs for troubleshooting. Use Console chat, email, or Support Center.
  • Cannot assume subaccount HIPAA inheritance — Existing subaccounts must be individually flagged.
  • Cannot use GET webhooks with Message Redaction — GET parameters are logged for 7 days.
  • Cannot use Marketplace add-ons — Even with a third-party BAA, Marketplace is not eligible.
  • Cannot use Conversation Intelligence for Conversations — Only Voice channel is HIPAA eligible.

---

Next Steps

  • Authentication setup: twilio-security-api-auth
  • Account structure for HIPAA isolation: twilio-account-setup
  • Credential security: twilio-security-hardening
  • Traffic compliance (TCPA, GDPR, PCI): twilio-compliance-traffic

Official docs: HIPAA Eligible Services (PDF) | Architecting for HIPAA (PDF) | HIPAA account flag | Message Redaction

Related skills

Securitycompliance

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.