- name
- openphone
- description
- Manage business phone calls, SMS, and contacts via OpenPhone API. Use when asked to send a text message, list calls or messages, look up conversation history with a contact, get voicemail transcripts, list phone numbers, or check call recordings. Requires OPENPHONE_API_KEY env var.
OpenPhone Skill
OpenPhone REST API base: https://api.openphone.com/v1
Auth
curl -H "Authorization: $OPENPHONE_API_KEY" \
-H "Content-Type: application/json" \
https://api.openphone.com/v1/...Phone Numbers
List Your Phone Numbers
curl "https://api.openphone.com/v1/phone-numbers" \
-H "Authorization: $OPENPHONE_API_KEY"
# Save phoneNumberId for sending messages/callsContacts
Search Contacts
curl "https://api.openphone.com/v1/contacts?query=John+Smith" \
-H "Authorization: $OPENPHONE_API_KEY"Create Contact
curl -X POST "https://api.openphone.com/v1/contacts" \
-H "Authorization: $OPENPHONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"firstName": "Jane",
"lastName": "Smith",
"phoneNumbers": [{"number": "+15551234567"}],
"emails": [{"address": "jane@acme.com"}],
"company": "Acme Corp"
}'Messages (SMS/MMS)
Send SMS
curl -X POST "https://api.openphone.com/v1/messages" \
-H "Authorization: $OPENPHONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "<phoneNumberId>",
"to": ["+15551234567"],
"content": "Hi Jane, following up on our conversation earlier!"
}'List Messages (Conversation History)
curl "https://api.openphone.com/v1/messages?phoneNumberId=<id>&participants[]=+15551234567&maxResults=20" \
-H "Authorization: $OPENPHONE_API_KEY"Calls
List Calls
curl "https://api.openphone.com/v1/calls?phoneNumberId=<id>&maxResults=20" \
-H "Authorization: $OPENPHONE_API_KEY"Get Call Details (Recording + Transcript)
curl "https://api.openphone.com/v1/calls/<call_id>" \
-H "Authorization: $OPENPHONE_API_KEY"
# Response includes: recordingUrl, transcript (if enabled), duration, directionList Voicemails
curl "https://api.openphone.com/v1/calls?type=voicemail&phoneNumberId=<id>" \
-H "Authorization: $OPENPHONE_API_KEY"Call Directions
incoming, outgoing
Message Status Values
queued, sending, delivered, failed, received
Tips
phoneNumberIdstarts withPN— always list phone numbers first- Transcripts require call recording to be enabled in workspace settings
- Rate limit: 60 req/min; batch message sends in loops with brief delays