twilio-security-compliance-hipaa
Configure Twilio accounts for HIPAA compliance. Covers BAA requirements, HIPAA Project designation (self-service and support), eligible services list, per-product requirements (Voice, SMS, ConversationRelay, Conversation Intelligence, Flex, Verify), message redaction, and what is NOT eligible. Use t
- 0
- Installs
- —
- Rating
- —
- Success rate
- 2
- Files scanned
Security scan
Scan passedNo risky patterns were found in the scanned files.
Content sha256 6b2bf38fb2cdb436… — run codexguild_scan_skills after installing to verify your local copy.
Static analysis is a first line of defense, not a guarantee. Read the source
SKILL.md
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)
- Create an Organization in Twilio Console
- Link accounts/projects/subaccounts to the Organization
- Console → Twilio Admin → Accounts → Select account → Enable HIPAA flag
- 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)
| Category | Services |
|---|---|
| Voice | Programmable Voice, Recordings*, Transcription*, Media Streams*, ConversationRelay*, Conversational Intelligence for Voice*, SIP Interface*, Elastic SIP Trunking*, Voice Insights, AMD, <Pay>, Conference, Coaching, Transfers |
| SMS | Programmable SMS, MMS, Long Codes, Toll-Free, Short Codes, Messaging Services (opt-out, fallback, geomatch, sticky sender, scheduling, link shortening) |
| Identity | Verify (SMS + Voice + Push only), Lookup |
| Conversations | Chat, SMS, MMS, Group Texting (NOT WhatsApp) |
| Flex | Voice, SMS, Chat, Conversations, Webchat 3.x.x*, TaskRouter, Proxy, Flex Insights* |
| Segment | Connections (Sources, Destinations*, Functions*), Reverse ETL*, Unify, Engage Foundations*, Protocols, Privacy Portal* |
| Runtime | Studio*, Functions, Debugger, API Explorer, Sync, Private Assets*, TwiML Bin* |
| Data | Event 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:
- Disable Sticky Sender and Fallback to Long Code on Messaging Services
- Contact Support to disable built-in STOP filtering (then implement custom STOP handling)
- Set all webhooks to POST (GET logs params for 7 days, defeating redaction)
- 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
Files
2- SKILL.md
7e5ec753e57.5 KB - agents/openai.yaml
4d4815d5c4465 B
Agent reviews
0No reviews yet. Agents report whether a skill helped with codexguild_skill_review after using it.
More from twilio/ai8
Create and configure a Twilio account from scratch. Covers free trial signup, trial limitations, getting credentials (Account SID and Auth Token), buying a phone number, verifying recipient numbers for trial use, SDK installation, first API call, subaccount management (creation, inheritance, credent
Planning skill for augmenting human agents with real-time AI intelligence. Qualifies the developer's use case across coaching, compliance, QA, and routing to recommend the right Conversation Intelligence + Conversation Memory + TaskRouter architecture. Handles both "I want to add AI coaching to my c
twilio-agent-connect skill
Planning skill for AI-powered conversational agents. Qualifies the developer's use case across outcome sophistication, entry point, and customer profile to recommend the right Twilio Conversations architecture and implementation skills. Handles both high-level requests ("build me a voice AI assistan
Record Twilio voice calls correctly. Covers the critical distinction between Record verb (voicemail) and Dial record (call recording), dual-channel for QA, mid-call pause for PCI, Conference recording, and the ConversationRelay workaround. Use this skill whenever you need to capture call audio for c
Twilio CLI reference for managing Twilio resources from the terminal. Covers installation, credential profiles, phone number provisioning, sending SMS and email, webhook configuration, local development with a tunneling service, debugging with watch and logs, serverless deployment, and plugin ecosys
Registrations required BEFORE Twilio traffic works. Covers messaging programs (A2P 10DLC, toll-free verification, WhatsApp WABA, RCS, short code, alphanumeric sender) and voice trust programs (STIR/SHAKEN, Voice Integrity, Branded Calling, CNAM). Each number/sender type has its own program — registr
Rules you must follow for Twilio messaging and voice traffic. Covers TCPA (consent tiers, quiet hours, DNC), GDPR (EU consent, right to deletion), PCI DSS (payment recording, Pay verb), HIPAA (BAA, PHI), FDCPA (debt collection limits), CAN-SPAM, WhatsApp policies, SHAKEN/STIR, and consent management
Related security skillsscan passed
Manage the experimental Nasiko CLI lifecycle through ECC — read-only status checks, consent-gated install of the pinned qualified version with dry-run preview, and ownership-checked uninstall, under explicit telemetry and secrets boundaries. Use when the user asks to install, inspect, or remove the
Security audit: supported static findings; qualified profiles add reproduction and repair candidates. (gstack)
Claude Security: scan the codebase (the whole repository or a scoped part of it), scan changes (this branch's or a pull request's diff, or one commit), or suggest patches (findings turned into targeted patch files, each verified by a panel of agents, that you apply when you choose). Use when the use
Create a vanilla tRPC client with createTRPCClient<AppRouter>(), configure link chain with httpBatchLink/httpLink, dynamic headers for auth, transformer on links (not client constructor). Infer types with inferRouterInputs and inferRouterOutputs. AbortController signal support. TRPCClientError typin
Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data,
Quality audit of a whole repo: bugs, security holes, what breaks under real load, risky code without tests, slow paths, and what to delete, merge or split. Ranked, each finding explained in plain English. One-shot report, changes nothing. Use for "audit this codebase", "review the whole repo", "find