@font-face {
  font-family: "Roobert";
  src: url("https://uploads-ssl.webflow.com/6384fdd9fd42380b529fc942/646dce023a43d52740e2f3c8_Roobert-SemiBold.ttf");
  font-weight: 600;
  font-style: normal;
}

@font-face {
  font-family: "Roobert";
  src: url("https://uploads-ssl.webflow.com/6384fdd9fd42380b529fc942/646dce02a844c04f2faca171_Roobert-Medium.ttf");
  font-weight: 500;
  font-style: normal;
}

h1,
h2,
h3 {
  font-family: "Roobert", sans-serif;
}

strong {
  color: inherit !important;
}

#topbar-cta-button {
  height: 36px;
}

#topbar-cta-button > a > span {
  background-color: #6439f5;
  border-radius: 10px;
}

#topbar-cta-button > a > div span,
#topbar-cta-button > a > div svg {
  color: white;
}


Response code categories

Common response codes

API Reference

Development Resources

Pricing & Support

OpenPhone Docs

Try for free

Feedback

Log in

OpenPhone uses standard HTTP response codes to indicate request status. 

API response codes

Introduction

Authentication

This is a step-by-step guide for sending your first text message.

Send your first message

Stay up to date with the latest improvements to the API.

Changelog

OpenPhone implements rate limiting to ensure API stability and fair usage.

Rate limits

Welcome to the OpenPhone API pricing guide.

Pricing Overview

We’ve provided the below tips to help you minimize segment counts and save money.

Tips for Minimizing Costs

Contact the Team

Terms of service

Learn more about working with contacts via the OpenPhone API.

Integration contacts

A reference for API-generated webhook payloads.

Webhooks

Implement a one-way contact sync from Google Sheets to OpenPhone using Javascript.

Sync your contacts

Fetch a paginated list of calls associated with a specific OpenPhone number and another number.

List calls

Retrieve a list of recordings associated with a specific call. The results are sorted chronologically, with the oldest recording segment appearing first in the list.

Get recordings for a call

Retrieve an AI-generated summary of a specific call identified by its unique call ID. Call summaries are only available on OpenPhone Business plan.

Get a summary for a call

Retrieve a detailed transcript of a specific call identified by its unique call ID. Call transcripts are only available on OpenPhone business plan.

Get a transcription for a call

Custom contact fields enhance your OpenPhone contacts with additional information beyond standard details like name, company, role, emails and phone numbers. These user-defined fields let you capture business-specific data. While you can only create or modify these fields in OpenPhone itself, this endpoint retrieves your existing custom properties. Use this information to accurately map and include important custom data when creating new contacts via the API.

Get contact custom fields

Create a contact

Retrieve detailed information about a specific contact in your OpenPhone workspace using the contact's unique identifier.

Get a contact by ID

Delete a contact by its unique identifier.

Delete a contact

Modify an existing contact in your OpenPhone workspace using the contact's unique identifier.

Update a contact by ID

Retrieve a chronological list of messages exchanged between your OpenPhone number and specified participants, with support for filtering and pagination. 

List messages

Send a text message from your OpenPhone number to a recipient.

Send a text message

Get a message by ID

Retrieve the list of phone numbers and users associated with your OpenPhone workspace.

Code	Status	Description
`200`	OK	Request successful
`400`	Bad Request	Invalid parameters
`401`	Unauthorized	Missing or invalid API key
`402`	Request Failed	The parameters were valid but the request failed.
`403`	Forbidden	Insufficient permissions
`404`	Not Found	Resource doesn’t exist
`409`	Conflict	Conflict with another request (perhaps due to using the same idempotent key).
`429`	Too Many Requests	Rate limit exceeded
`500`	Server Error	OpenPhone-side issue

Getting Started

Essentials

Calls

Contact Custom Fields

Contacts

Messages

Phone Numbers

Webhooks

API response codes

Response code categories

Common response codes

Getting Started

Essentials

Calls

Contact Custom Fields

Contacts

Messages

Phone Numbers

Webhooks

​Response code categories

​Common response codes

Response code categories

Common response codes