All the most recent updates and improvements to Surgehttps://surge.app/en-ushttps://surge.app/changelog/https://surge.app/changelog/When sending a Blast through our API, it was already possible to provide the phone number from which the Blast should be sent. HQ didn't previously support that feature though, so we've now added a dropdown so that you can select which phone number should send the Blast when sending through our UI.Wed, 01 Apr 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We've now added Retell as a supported AI agent platform for Voice. On the phone number settings page, you can select to have inbound calls handled by an AI agent, then select Retell as your platform of choice. By providing your Retell API key, we will import your Surge phone number into Retell for you so that your Retell agent can make and receive calls using your Surge phone number.Tue, 31 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/For phone calls through the ElevenLabs agent platform, we had some issues where calls were cut short when we deployed a change to our servers. That has now been fixed, so ElevenLabs agent calls should now be more reliable.Mon, 30 Mar 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/While Canadian accounts could previously be created manually through HQ, we've now added the ability to create Canadian accounts through the API as well. Accounts in Canada will need to have a valid Canadian Business Number instead of an EIN. You can validate the business number beforehand using [Canada's Business Registries](https://ised-isde.canada.ca/cbr-rec/en/search) and [Federal Corporation Search](https://ised-isde.canada.ca/cc/lgcy/fdrlCrpSrch.html). If the business was registered provincially or doesn't appear in either of the registries, a special registration process will be needed which requires additional fees. Reach out to support for more information.Thu, 26 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We've updated the embedded components to use message clustering similar to the way iMessage does it. Messages sent within a minute of each other will be grouped together with less spacing than normal, and messages sent within an hour of each other will be grouped under a date/time header. This helps to declutter the conversation view and provide a more familiar interface for customers. Right now this new functionality is disabled by default. If you would like it enabled for your project, please reach out to support. Once we've tested it thoroughly, we will enable it for all projects.Tue, 24 Mar 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/For users in our private beta for recording calls, you now have the ability to always record outbound calls as well as inbound calls. In the phone number settings, you will see a new "Record outbound calls" checkbox right below the "Record inbound calls" checkbox. Currently this functionality can only be enabled or disabled for all calls. We have no way to override it on a specific call yet.Tue, 24 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We have added an endpoint for listing all of the users in an account. See the [documentation for the list users endpoint](https://docs.surge.app/api-reference/endpoint/users/list) for more information.Mon, 23 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/When an area code was provided to the API for purchasing a phone number, and that area code is associated with a country or territory outside the US (like the `345` area code for the Cayman Islands), our system was returning an unknown error. We will now handle that properly and return an error explaining that the area code is not valid.Sun, 22 Mar 2026 00:00:00 GMTbugfixhttps://surge.app/changelog/https://surge.app/changelog/We've added new endpoints for getting a recording or listing all the recordings in an account. This will be especially helpful for making sure that you've deleted all recordings if you don't want to pay Surge to store them for you. See the documentation for the [get recording endpoint](https://docs.surge.app/api-reference/endpoint/recordings/get) and [list recordings endpoint](https://docs.surge.app/api-reference/endpoint/recordings/list) for more information.Fri, 20 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/For projects in the beta for our embeddable softphone, you can now route inbound calls to a list of multiple users instead of just a single user. When you do this, all users' softphones will ring simultaneously, and the first user to answer the call will receive it.Fri, 20 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Some code paths for creating a message weren't saving message metadata properly, and the metadata wasn't being returned in the API responses. This has been fixed so that message metadata will now work as expected.Wed, 18 Mar 2026 00:00:00 GMTbugfixhttps://surge.app/changelog/https://surge.app/changelog/Our embedded softphone component will now take a `phone_number_id` parameter to allow you to specify the phone number from which any outbound calls should be made.Mon, 16 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Our existing [`campaign.approved` webhook event](https://docs.surge.app/api-reference/webhooks/campaign/approved) notifies you when a campaign has been approved, but each phone number needs to be attached to a campaign as well before it can begin sending. Now we've added a `phone_number.attached_to_campaign` webhook event as well so that you can be notified when phone number attachment is complete. See the [documentation for the new webhook event](https://docs.surge.app/api-reference/webhooks/phone_number/attached_to_campaign) for more information.Wed, 11 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/For platform customers with many accounts, finding the account you needed would often require ⌘+F to make it work. We've now added a search input on both our accounts page and the account switcher on our other pages so that you can easily find the account you need. In addition, we've changed both the switcher and the accounts page to display the accounts in alphabetical order so that you can more easily scan through them.Fri, 06 Mar 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/We have added a new API endpoint for moving a phone number to another account under your project.Tue, 03 Mar 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/For our customers in Canada (or who have their own customers in Canada), you will now be able to purchase Canadian phone numbers both through HQ and our API. In HQ you will need to switch the country in the picker on the page for purchasing a phone number, and then you can also search for Canadian area codes. With our API, you will need to provide a Canadian area code, and then if we have any inventory in that area code, the number will be purchased.Thu, 26 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Since adding blasts and segments in 2024, we haven't made many improvements to it. It's been a long time coming, but we finally added pagination to the audience contacts page in HQ so that the page will load a lot faster and not crash your browser if you have an audience with thousands of contacts.Wed, 25 Feb 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/For those of you using segments to segment the contacts in your account, we have now renamed segments to audiences. This is because segments is also used to refer to SMS segments, and we wanted to separate the terms to make it easier to clarify what was being discussed. There are no breaking changes to the API because we have not yet exposed endpoints for segments, but we will create new audience endpoints soon.Wed, 25 Feb 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/We just added a new billing settings page. By clicking your name in the bottom left corner of the screen on desktop, or your avatar in the top right on mobile, you can then select "Billing." This page will allow you to view and download your past invoices, change or cancel your usage commitment, or update the payment method on file for your project.Tue, 24 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Our UI is now set up to enable Canadian entities to register campaigns through the dashboard. The necessary changes will be made to the API as well in the near future.Mon, 23 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We've added a password visibility toggle to the login, registration, and change password screens so that you'll be able to see your password if necessary.Mon, 23 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We previously added a `metadata` field to messages to allow you to pass information from your system when sending a message. However, we forgot to add that to the message webhooks (`message.received`, `message.delivered`, `message.sent`, and `message.failed`). That will now be included on those webhooks.Fri, 20 Feb 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/We've added a new endpoint for listing the campaigns in an account. For more information, see the [documentation for the list campaigns endpoint](https://docs.surge.app/api-reference/endpoint/campaigns/list).Fri, 20 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Pages where no user was logged in previously used light mode by default, whereas pages with a logged in user would use dark mode. Sorry for burning your eyes. We will now use your system theme everywhere in HQ.Tue, 17 Feb 2026 00:00:00 GMTbugfixhttps://surge.app/changelog/https://surge.app/changelog/We've now added an endpoint to allow you to delete recordings. This will allow you to remove them from Surge's storage so that you won't be billed for them, or in case you want them deleted for privacy reasons. See the [documentation for the delete recording endpoint](https://docs.surge.app/api-reference/endpoint/recordings/delete) for more details.Mon, 16 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Historically we've sent emails directly to our email provider, but we were seeing several issues where their server didn't accept the email and it never got sent. We've now cloned our SMS messaging queue infrastructure for emails so that failed emails will automatically be retried, and we can guarantee that email notifications are delivered at least once.Fri, 13 Feb 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/We now allow you to record your incoming calls. By enabling this feature the call will be recorded and we will send you a `recording.completed` webhook as soon as the recording has been processed and stored. You can then download the recording. Please note that you are responsible for compliance with federal and state laws surrounding recording phone calls.Tue, 10 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/You can now export your usage as a CSV. While this won't be a big deal for those of you with single-account projects, for our customers with many accounts, this will allow you to get the breakdown of line items for all of your accounts in a single CSV so that you can easily break down usage by accounts for attributing costs. Let us know if there's anything else you'd like to see in that CSV or anywhere else you'd like to see similar export buttons.Tue, 10 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We added a new endpoint for getting a campaign. This will allow you to check the details of a campaign that you've previously submitted, as well as check the status of the campaign. See the [documentation for the get campaign endpoint](https://docs.surge.app/api-reference/endpoint/campaigns/get) for more details.Sat, 07 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Verifications still require that recipients be able to opt out of receiving messages. In the event that a Verification is created and the recipient has opted out of receiving messages, we will now return an error response with instructions for the recipient to opt back in, rather than failing silently as we did before. An error response will look something like this: ```json { "error": { "type": "opted_out", "message": "This number has opted out of receiving verification messages. Send START to (801) 555-1234 to opt in again." } } ```Sat, 07 Feb 2026 00:00:00 GMTbugfixhttps://surge.app/changelog/https://surge.app/changelog/For our customers making outbound calls, we can now register your business with the carriers to avoid the "Spam Likely" label on outbound calls.Wed, 04 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Sometimes you or your customers would rather handle incoming calls asynchronously rather than in the moment a customer calls. We've now shipped voicemail in beta to allow you to receive voice messages from callers. By enabling voicemail on a phone number, we allow you to provide a greeting message. When someone calls your number, they will hear the greeting and be given the opportunity to record a message for you. We will then send you a `voicemail.received` webhook to let you know that the voicemail was received and is ready for download.Tue, 03 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We've added a new endpoint for listing all the contacts in an account. See the [documentation for the list contacts endpoint](https://docs.surge.app/api-reference/endpoint/contacts/list) for more details.Sun, 01 Feb 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We've added a new endpoint for listing all the messages sent and received from an account. See the [documentation for the list messages endpoint](https://docs.surge.app/api-reference/endpoint/messages/list) for more details.Sat, 31 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Messages with attachments aren't required to have a message body, and messages aren't required to be associated with a blast. We previously had both fields in our OpenAPI spec and our SDK types show that a string would always be returned, but we have now updated that to allow string or null to reflect the actual behavior of the API.Fri, 30 Jan 2026 00:00:00 GMTbugfixhttps://surge.app/changelog/https://surge.app/changelog/We've added a new endpoint for listing all the phone numbers in your account. See the [documentation for the list phone numbers endpoint](https://docs.surge.app/api-reference/endpoint/phone-numbers/list) for more details.Mon, 26 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Whenever changes were needed on a toll-free verification, we displayed that on the phone number page, but we didn't provide a link to allow you to make those changes. We now include a button that links to the form where you can make the necessary changes.Sun, 25 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Blasts previously would always be sent from the default phone number on the account sending the blast. We added a `from` field which allows you to provide the phone number from which the blast should be sent. This should be helpful for users with multiple phone numbers in a single account. See [the docs for creating a blast](https://docs.surge.app/api-reference/endpoint/blasts/create#body-from) for more details.Sun, 25 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/We added a `blast_id` field to the message schema so that anywhere that our customers who use blasts will be able to more easily track all of the messages sent by a blast. See [the docs for messages](https://docs.surge.app/api-reference/endpoint/messages/get#response-blast-id).Sat, 24 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Once an SMS autoresponse message was set, the form on the phone number settings page would hide itself when you attempted to change it. This made it impossible to edit the autoresponse message. We've fixed this issue so that the form remains visible, allowing you to edit it once it's been set.Thu, 22 Jan 2026 00:00:00 GMTbugfixhttps://surge.app/changelog/https://surge.app/changelog/Previously when an invalid id was passed to the [embeddable unread count component](https://docs.surge.app/ui/components/unread-count), the filters would just be ignored, and the component would show the count of all messages the user could view but hadn't read. We have now fixed this behavior so that if an invalid filter id is provided, the component will hide the unread count entirely, similar to how it behaves when the user has no unread messages. This change helps prevent confusion so that it won't appear that there are unread messages when the filters are not valid.Wed, 21 Jan 2026 00:00:00 GMTbugfixhttps://surge.app/changelog/https://surge.app/changelog/We now support attaching custom metadata to messages sent via the API. Like the metadata fields on Contacts and Users, this allows you to store additional information relevant to your application. Metadata can be used for filtering, reporting, tracking, and analytics. The metadata field allows you to attach up to 50 key-value pairs to a message, with each value being a string up to 500 characters long. For more information, see the documentation for the [Create message endpoint](https://docs.surge.app/api-reference/endpoint/messages/create#body-one-of-0-metadata).Sun, 18 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/By default, any links included in messages sent through our platform are shortened to better fit within a single SMS segment. These links are also tracked to provide insights on user engagement. Historically we've only shown statistics about link clicks within our dashboard and the embedded inbox component. With this update, we've introduced a new `link.followed` webhook event that notifies you whenever a recipient follows a tracked link. For more information, see the documentation for the [link followed webhook](https://docs.surge.app/api-reference/webhooks/link/followed).Sun, 18 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Users can now be deleted via the API using `DELETE /users/{user_id}`. Deleting a user removes their access to any any embedded UI components, and they will no longer show up as targets for incoming calls. Any messages sent by that user will still show the user's name as the sender. For more information, see the [documentation for the delete user endpoint](https://docs.surge.app/api-reference/endpoint/users/delete).Thu, 15 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/You can now filter API logs by request ID, making it easier to trace specific requests and debug issues. This also makes it so that you can link to individual log entries directly for sharing with your team or with Surge support.Tue, 13 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Toll-free numbers will now require business information for verification. This matches the requirements for local numbers and helps to prevent spam from application-to-person messaging. The carriers are requiring this change to be implemented for all SMS APIs before February, so we've added these fields now to ensure compliance ahead of time. Now when registering a toll-free number, you'll be prompted to provide the following fields: * Business Type (sole proprietorship, corporation, LLC, etc.) * Legal Business Name (as registered with the IRS) * EIN (Employer Identification Number) Sole proprietors will still be able to register toll-free numbers without needing an EIN, but all other business types will need to provide this information for verification.Mon, 12 Jan 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/Accounts can now be archived both from the dashboard and via the API. Archiving an account removes it from the account list, releases all phone numbers in the account, and deactivates any campaigns in the account. After an account is archived, messages and other resources can no longer be created in the account. Please note that this will not delete the associated data. To permanently delete an account and its data, please contact Surge support. ## Dashboard To archive an account from the dashboard, navigate to the account settings page and look for the "Archive" button in the top right corner of the page. ## API Accounts can be archived from the API using the `DELETE /accounts/{account_id}` endpoint. See the [API documentation](https://docs.surge.app/api-reference/endpoint/accounts/archive) for more information.Sun, 11 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Webhook endpoint URLs can now be up to 2048 characters long, accommodating more complex configurations and integrations.Fri, 09 Jan 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/The embeddable phone component can now receive incoming calls. This allows users to take calls directly within the embedded UI, enhancing the communication experience.Fri, 09 Jan 2026 00:00:00 GMTfeaturehttps://surge.app/changelog/https://surge.app/changelog/Rather than displaying a generic error message when something goes wrong on our servers, we've implemented a custom 500 error page that provides a little more direction. Hopefully you never get the chance to see it, but it will be slightly more delightful when you do.Fri, 02 Jan 2026 00:00:00 GMTimprovementhttps://surge.app/changelog/https://surge.app/changelog/You can now provide a `phone_number_id` parameter to the Inbox component to tell it to only show conversations associated with a specific phone number. This is great for use cases where you have multiple phone numbers and want to embed the Inbox component for each individual number separately. See the [Inbox component documentation](https://docs.surge.app/ui/components/inbox#installation) for more details.Thu, 01 Jan 2026 00:00:00 GMTfeature