API Changelog

Last updated: April 7, 2026

Below is a log of changes to Switchboard's Public API. For getting set up and full documentation on the API, visit: https://api.oneswitchboard.com/v1/docs

For any feedback or questions, please email developers@oneswitchboard.com.

Apr 7, 2026

Phone Lookup and Messages Added GET /v1/phones/{e164_number} to look up a phone's metadata by E.164 number, and GET /v1/phones/{e164_number}/messages to retrieve the full conversation history of messages between that phone number and your organization. These endpoints support integrations that need to look up contact details or message history from a phone number directly. Note that these are beta endpoints and responses are subject to change.

Email Blast Content Added optional html_content and text_content fields to the Email Blast endpoints. Pass include_html_content=true or include_text_content=true as query parameters to include them in the response.

New Fields on Phone and Email Lists Added city and street_address as available fields when creating phone lists and email lists.

Phone Message Fields Added message_direction, received_at, and is_phone_opted_out to phone message payloads within a "List Broadcast Phone Messages" response.

Label Name Validation Label names are now validated to a maximum of 255 characters. Requests with longer names will return a 400 error.

Mar 5, 2026

Fix list endpoints pagination filter preservation

next_page_url in list payloads now preserve filter= query parameter expressions

Jan 20, 2026

Create and Send Broadcasts

Added support to create and send text broadcasts directly via the API. The expected flow is:

Upload Media

Added new endpoints to upload text, video, contact cards, and more to Switchboard, and to retrieve your media library via the API. This can be used along with the broadcast endpoints to send MMS texts with media.

Saved Searches

Creating a Search

You can now create Saved Searches via the API. Due to the complexity of validating the input and ensuring all combinations work correctly, we will be rolling out support for various filter types over time. See criteria.include.filters.kind in the documentation for a full list of supporter filter kinds. As part of the initial change, we support:

  • Donation filters

  • Optouts & Unsubscribe filters

  • Label filters

  • New to Universe filters

  • Audience filters (including other lists or sesarches)

  • Carrier filters (for phone searches)

  • Domain filters (for email searches)

  • Group filters (finding any or all matches among a set of other filters)

Refreshing a Search

We've added support for triggering a refresh of an existing search via the API, or converting the search into a static list. This can be used to ensure that evaluations happen on a particular cadence that matches your organization's needs.

September 2, 2025

Updating Error Code Details

Updated the phone messages endpoint to include the Switchboard error code and error message, the provider error code, the provider error details (JSON details about the error), and in cases where we skipped sending a message, the skip reason.

August 27, 2025

Documentation Update

Updated documentation at https://api.oneswitchboard.com/v1/docs to include more example sample code, including in Python.

August 25, 2025

Saved Search Endpoints

Added the ability to Export a Saved Search, including options to configure which fields to include in the CSV.

August 20, 2025

Export Phones and Export Emails

Added the ability to customize exports for All Phones and All Emails, to configure which fields to include in the CSV.

Saved Search Endpoints

Added the ability to Refresh a Saved Search, and Convert a Saved Search to a List.

August 12, 2025

Saved Search Endpoints

Added the ability to list and retrieve Saved Searches within your organization. This includes the ability to filter and search for specific searches by specific criteria.
See documentation about Filtering for more details on how to structure those requests.