--- title: "Changes to Create an Incoming Phone Number" method: POST path: "/Accounts/{AccountSid}/IncomingPhoneNumbers" --- # Changes to Create an Incoming Phone Number `POST /Accounts/{AccountSid}/IncomingPhoneNumbers` > Every recorded change to this operation, newest first. ## Timeline Changed in 13 of 47 revisions. - **2026-05-12** `2916d5e3072e`: 4 breaking, 4 info - **2026-05-12** `5344c0c93a4c`: 1 breaking, 5 info - **2026-03-04** `2e516ba2383f`: 12 breaking - **2026-01-21** `250c3ae23842`: 1 breaking - **2026-01-19** `d5fbaaddfa3e`: 10 breaking, 6 warning, 3 info - **2026-01-15** `50dab84bcf02`: 1 breaking - **2026-01-15** `479ede876c89`: 1 info - **2026-01-15** `a10b019314cd`: 2 warning - **2026-01-15** `07f73f74a61d`: 1 breaking, 1 info - **2026-01-15** `518ffc8751b7`: 2 info - **2026-01-15** `6b2611cfa74b`: 4 breaking - **2026-01-15** `686ef84c2abc`: 5 breaking, 4 info - **2026-01-15** `3c88f14db21e`: 6 breaking, 4 warning, 25 info ## Changes - **2026-05-12** `2916d5e3072e`: 4 breaking, 4 info - added `#/components/schemas/uuid` to the `SmsApplicationSid` request property `allOf` list - added `#/components/schemas/uuid` to the `VoiceApplicationSid` request property `allOf` list - the `account_id` response's property type changed from `string` to no type, and format from `uuid` to no format for status `201` - the `account_sid` response's property type changed from `string` to no type, and format from `uuid` to no format for status `201` - the `SmsApplicationSid` request property type was generalized from `string` to no type, and format from `uuid` to no format - the `VoiceApplicationSid` request property type was generalized from `string` to no type, and format from `uuid` to no format - added `#/components/schemas/uuid` to the `account_id` response property `allOf` list for the response status `201` - added `#/components/schemas/uuid` to the `account_sid` response property `allOf` list for the response status `201` - **2026-05-12** `5344c0c93a4c`: 1 breaking, 5 info - added 'unevaluatedProperties' constraint to the request body - added 'unevaluatedProperties' constraint to the response body for the status `201` - added 'unevaluatedProperties' constraint to the response body for the status `400` - added 'unevaluatedProperties' constraint to the response body for the status `401` - added 'unevaluatedProperties' constraint to the response body for the status `422` - added 'unevaluatedProperties' constraint to the `capabilities/allOf[#/components/schemas/IncomingPhoneNumberCapabilities]/` response property for the status `201` - **2026-03-04** `2e516ba2383f`: 12 breaking - response property `address_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `emergency_address_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `identity_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `sms_application_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `sms_fallback_url` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `sms_url` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `status_callback` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `trunk_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `voice_application_sid` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `voice_caller_id_lookup` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `voice_fallback_url` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - response property `voice_url` list-of-types was widened by adding types `null` to media type `application/json` of response `201` - **2026-01-21** `250c3ae23842`: 1 breaking - removed the enum value `none` of the request property `VoiceReceiveMode` - **2026-01-19** `d5fbaaddfa3e`: 10 breaking, 6 warning, 3 info - the `PhoneNumber` request property's minLength was increased from `0` to `6` - added the pattern `^\+\d{5,17}$` to the request property `PhoneNumber` - the `SmsApplicationSid` request property format changed from no format to `uuid` - the `SmsFallbackUrl` request property format changed from no format to `uri` - the `SmsUrl` request property format changed from no format to `uri` - the `StatusCallback` request property format changed from no format to `uri` - the `VoiceApplicationSid` request property format changed from no format to `uuid` - the `VoiceFallbackUrl` request property format changed from no format to `uri` - the `VoiceUrl` request property format changed from no format to `uri` - removed the success response with the status `200` - the `PhoneNumber` request property's maxLength was set to `18` - removed the request property `AddressSid` - removed the request property `AreaCode` - removed the request property `IdentitySid` - removed the request property `TrunkSid` - removed the request property `VoiceCallerIdLookup` - added the new `none` enum value to the request property `VoiceReceiveMode` - added the non-success response with the status `422` - added the success response with the status `201` - **2026-01-15** `50dab84bcf02`: 1 breaking - request body became required - **2026-01-15** `479ede876c89`: 1 info - request body became optional - **2026-01-15** `a10b019314cd`: 2 warning - removed the optional property `account_id` from the response with the `200` status - removed the optional property `country_code` from the response with the `200` status - **2026-01-15** `07f73f74a61d`: 1 breaking, 1 info - removed the media type `application/json` from the request body - added the media type `application/x-www-form-urlencoded` to the request body - **2026-01-15** `518ffc8751b7`: 2 info - added the optional property `account_id` to the response with the `200` status - added the optional property `country_code` to the response with the `200` status - **2026-01-15** `6b2611cfa74b`: 4 breaking - the request property `SmsApplicationSid` became not nullable - the request property `SmsFallbackUrl` became not nullable - the request property `SmsUrl` became not nullable - the request property `VoiceApplicationSid` became not nullable - **2026-01-15** `686ef84c2abc`: 5 breaking, 4 info - the response property `emergency_address_sid` became nullable for the status `200` - the response property `sms_application_sid` became nullable for the status `200` - the response property `sms_fallback_url` became nullable for the status `200` - the response property `sms_url` became nullable for the status `200` - the response property `voice_application_sid` became nullable for the status `200` - the request property `SmsApplicationSid` became nullable - the request property `SmsFallbackUrl` became nullable - the request property `SmsUrl` became nullable - the request property `VoiceApplicationSid` became nullable - **2026-01-15** `3c88f14db21e`: 6 breaking, 4 warning, 25 info - request body became required - removed the media type `application/x-www-form-urlencoded` from the request body - the `address_requirements` response's property type changed from `string` to no type for status `200` - the `capabilities` response's property type changed from `object` to no type for status `200` - the `emergency_status` response's property type changed from `string` to no type for status `200` - the `origin` response's property type changed from `string` to no type for status `200` - removed the optional property `capabilities/Fax` from the response with the `200` status - removed the optional property `capabilities/MMS` from the response with the `200` status - removed the optional property `capabilities/SMS` from the response with the `200` status - removed the optional property `capabilities/Voice` from the response with the `200` status - added the media type `application/json` to the request body - added the non-success response with the status `400` - added the non-success response with the status `401` - added `#/components/schemas/AddressRequirements` to the `address_requirements` response property `allOf` list for the response status `200` - added `#/components/schemas/EmergencyStatus` to the `emergency_status` response property `allOf` list for the response status `200` - added `#/components/schemas/IncomingPhoneNumberCapabilities` to the `capabilities` response property `allOf` list for the response status `200` - added `#/components/schemas/PhoneNumberOrigin` to the `origin` response property `allOf` list for the response status `200` - removed the `GET` enum value from the `sms_fallback_method` response property for the response status `200` - removed the `GET` enum value from the `sms_method` response property for the response status `200` - removed the `GET` enum value from the `status_callback_method` response property for the response status `200` - removed the `GET` enum value from the `voice_fallback_method` response property for the response status `200` - removed the `GET` enum value from the `voice_method` response property for the response status `200` - removed the `POST` enum value from the `sms_fallback_method` response property for the response status `200` - removed the `POST` enum value from the `sms_method` response property for the response status `200` - removed the `POST` enum value from the `status_callback_method` response property for the response status `200` - removed the `POST` enum value from the `voice_fallback_method` response property for the response status `200` - removed the `POST` enum value from the `voice_method` response property for the response status `200` - removed the `active` enum value from the `emergency_status` response property for the response status `200` - removed the `any` enum value from the `address_requirements` response property for the response status `200` - removed the `foreign` enum value from the `address_requirements` response property for the response status `200` - removed the `hosted` enum value from the `origin` response property for the response status `200` - removed the `inactive` enum value from the `emergency_status` response property for the response status `200` - removed the `local` enum value from the `address_requirements` response property for the response status `200` - removed the `none` enum value from the `address_requirements` response property for the response status `200` - removed the `signalwire` enum value from the `origin` response property for the response status `200` --- [Operation](https://skmtc.dev/signalwire/apis/compatibility-api/docs/Accounts/:AccountSid/IncomingPhoneNumbers/post.md) - [API](https://skmtc.dev/signalwire/apis/compatibility-api.md) - [Page](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/IncomingPhoneNumbers/post)