# Create an IncomingPhoneNumber Use this endpoint for the [IncomingPhoneNumber](./index.mdx) method to create an IncomingPhoneNumber. ## Parameters | Parameter | Description | | :-- | :-- | | AccountSid required | The unique identifier of the account associated with this phone number. | | AreaCode required*if PhoneNumber is not present | The area code of your new number. A new number within this area code will be generated for you. | | PhoneNumber required*if AreaCode is not present | The new number, in E.164 format, you would like to buy. | | AddressSid optional | The unique identifier for the address associated with this phone number. | | FriendlyName optional | The formatted version of the phone number. | | IdentitySid optional | The unique identifier for the identity associated with this phone number. | | SmsApplicationSid optional | The unique identifier for the application associated with SMS handling on this phone number. If SmsApplicationSid is present, the URLs on the application will be used and all other URLs will be ignored. | | SmsFallbackMethod optional | Whether the request to SmsFallbackUrl is a GET or a POST. Default is POST. | | SmsFallbackUrl optional | The URL to request if errors occur when fetching SmsUrl. | | SmsMethod optional | Whether the request to SmsUrl is a GET or a POST. Default is POST. | | SmsUrl optional | The URL to request when an incoming SMS is received. | | StatusCallback optional | The URL to request to pass status updates to. | | StatusCallbackMethod optional | Whether the request to StatusCallback is a GET or a POST. Default is POST. | | TrunkSid optional | The unique identifier for the Trunk associated with this phone number. | | VoiceApplicationSid optional | The unique identifier for the application associated with call handling on this phone number. If VoiceApplicationSid is present, the URLs on the application will be used and all other URLs will be ignored. | | VoiceCallerIdLookup optional | Whether or not to look up a callers name in the database. Possible values are true or false. | | VoiceFallbackMethod optional | Whether the request to VoiceFallbackUrl is a GET or a POST. Default is POST. | | VoiceFallbackUrl optional | The URL to request if errors occur when fetching Url. | | VoiceMethod optional | Whether the request to Url is a GET or a POST. Default is POST. | | VoiceReceiveMode optional | Whether this number can receive calls or fax. Possible values are voice or fax. Default is **voice**. | | VoiceUrl optional | The URL to request when a phone number receives a call or fax. | ## Request 201 CREATED
json { address_requirements: none, api_version: 2010-04-01, beta: false, capabilities: { mms: true, sms: false, voice: true }, date_created: Tue, 25 Sept 2018 23:00:00 +0000, date_updated: Wed, 26 Sept 2018 22:00:00 +0000, emergency_status: Inactive, friendly_name: IncomingPhoneNumber1, origin: origin, phone_number: +13103386745, sms_fallback_method: POST, sms_fallback_url: , sms_method: POST, sms_url: , status_callback: , status_callback_method: POST, uri: /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/IncomingPhoneNumbers/b3877c40-da60-4998-90ad-b792e98472pn.json, voice_caller_id_lookup: false, voice_fallback_method: POST, voice_fallback_url: null, voice_method: GET, voice_url: http://your-application.com/docs/voice.xml }