# Create port-in order

Create an order to port phone numbers from another carrier into Sinch. Refer to the Port-In Status section for more information on port-in order updates.
Please note that order will fail if you try to port numbers that are not portable, so you should always use the portability check before creating an order.

Note: For port orders of over 500 numbers, please contact the support team.

 In order to send SMS and MMS messages in the US using 10DLC phone numbers, all messages must be sent via an approved campaign. Your campaigns are managed under US 10DLC Campaigns in the SMS section. A number can be associated to an approved campaign after the port completes.

Endpoint: POST /orders/portIns
Version: 1.0
Security: basicAuth, bearerAuth

## Request fields (application/json):

  - `desiredPortSchedule` (object, required)
    The date and time you want the numbers to be ported in. If you set a  and  in defaults those settings will be used if not set per order. If you haven't set defaults and do not set the time and time zone on the order the system default will be used.

 09:00:00 US/Eastern

  - `desiredPortSchedule.desiredPortDate` (string, required)
    The date you want the numbers to be ported in, in ISO format.
    Example: "2025-01-31"

  - `desiredPortSchedule.desiredPortTime` (string)
    The time you want the numbers to be ported in.
    Example: "09:00:00"

  - `desiredPortSchedule.desiredPortTimeZone` (string)
    The time zone you want to use for the desired port time.
    Enum: "US/Eastern", "US/Central", "US/Mountain", "US/Pacific"

  - `phoneNumbers` (array, required)
    The numbers for the order in e164 format

  - `phoneNumbers.phoneNumber` (string, required)
    The phone number in [E.164](https://community.sinch.com/t5/Glossary/E-164/ta-p/7537) format.
    Example: "+12345678901"

  - `phoneNumbers.endUser` (object, required)
    If specified, this will override the endUser for the order.

  - `phoneNumbers.endUser.name` (string, required)
    The name of the end user can be a person's name or company name. Please note if you are not using this yourself it should be the name/company of the actual user.
    Example: "Joe Doe"

  - `phoneNumbers.endUser.streetNum` (string, required)
    The end user's street number.
    Example: "123"

  - `phoneNumbers.endUser.streetName` (string, required)
    The end user's street name.
    Example: "Main"

  - `phoneNumbers.endUser.city` (string, required)
    The end user's city.
    Example: "Anytown"

  - `phoneNumbers.endUser.state` (string, required)
    The end user's state, using the two letter abbreviation.
    Example: "CA"

  - `phoneNumbers.endUser.zipCode` (string, required)
    The end user's zip code.
    Example: "12345"

  - `phoneNumbers.endUser.streetPreDir` (string)
    The prefix direction in the end user's address, if any.
    Example: "N"

  - `phoneNumbers.endUser.streetType` (string)
    The end user's street type, for example Road or Court.
    Example: "Court"

  - `phoneNumbers.endUser.streetPostDir` (string)
    The suffix direction in the end user's address, if any.
    Example: "SW"

  - `phoneNumbers.endUser.locationType1` (string)
    Any additional location information, such as suite or apartment.
    Example: "Suite"

  - `phoneNumbers.endUser.locationValue1` (string)
    Any additional location information, such as suite number or apartment number.
    Example: "2134"

  - `phoneNumbers.endUser.locationType2` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.locationValue2` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.locationType3` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.locationValue3` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.typeOfService` (string)
    The type of address. Available values are  for Business or  for Residence
    Enum: "B", "R"

  - `phoneNumbers.portOutInfo` (object, required)
    The port out information at the previous carrier for the number. Usually only a port-out PIN is required.

  - `phoneNumbers.portOutInfo.existingPortOutPin` (string)
    The existing port-out PIN from the previous carrier.

  - `phoneNumbers.portOutInfo.accountNum` (string)
    The account number associated with the number from the previous carrier.

  - `phoneNumbers.portOutInfo.accountPhoneNumber` (string)
    The contact phone number on the account.

  - `phoneNumbers.portOutInfo.authorizingName` (string)
    Name of the person authorizing the port-in.

  - `phoneNumbers.portOutInfo.authorizingDate` (string)
    Date of authorizing the port-in (must be today or earlier and cannot be in the future). Formatted as [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601): .
    Example: "2024-09-24T12:00:00Z"

  - `phoneNumbers.voiceConfiguration` (any)

  - `phoneNumbers.smsConfiguration` (object)
    If specified, this will override the sms configuration for the order.

  - `phoneNumbers.smsConfiguration.smsAppId` (string)

  - `phoneNumbers.features` (object)

  - `phoneNumbers.features.e911` (object)
    An object describing the emergency 911 contact address associated with the number.

  - `phoneNumbers.features.e911.name` (string)
    The contact name.

  - `phoneNumbers.features.e911.streetNum` (string)
    The street number for the emergency address.
    Example: "12345"

  - `phoneNumbers.features.e911.streetInfo` (string)
    The street name of the emergency location.
    Example: "Main St"

  - `phoneNumbers.features.e911.location` (string)
    The location for address.
    Example: "Apt 5"

  - `phoneNumbers.features.e911.city` (string)
    The city of the emergency location.
    Example: "Springfield"

  - `phoneNumbers.features.e911.state` (string)
    The state or province of the emergency location.
    Example: "IL"

  - `phoneNumbers.features.e911.postalCode` (string)
    The postal code of the emergency location.
    Example: "62701"

  - `phoneNumbers.features.e911.postalCodePlusFour` (string)
    The postal code of the emergency location.
    Example: "1234"

  - `phoneNumbers.newPortOutPin` (string)

  - `customerOrderReference` (string)
    Your reference you specified when creating the order
    Example: "123456"

  - `onDemandActivation` (boolean)
    If you use onDemand activation you will need to make sure the numbers are both confirmed and released for activation, if you don't use onDemand the numbers will be activated on the desiredPortDate is the recommended way.
If true the numbers will be activated as when you call , if false they will be activated on the desiredPortDate

  - `loaUploadedBy` (string)
    Name of the user uploading the LOA
    Example: "john doe"

  - `loaAttachmentDate` (string)
    Date when the LOA was uploaded. Formatted as [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601): .
    Example: "2024-09-24T12:00:00Z"

  - `resellerName` (string)

## Response 201 fields (application/json):

  - `desiredPortSchedule` (object, required)
    The date and time you want the numbers to be ported in. If you set a  and  in defaults those settings will be used if not set per order. If you haven't set defaults and do not set the time and time zone on the order the system default will be used.

 09:00:00 US/Eastern

  - `desiredPortSchedule.desiredPortDate` (string, required)
    The date you want the numbers to be ported in, in ISO format.
    Example: "2025-01-31"

  - `desiredPortSchedule.desiredPortTime` (string)
    The time you want the numbers to be ported in.
    Example: "09:00:00"

  - `desiredPortSchedule.desiredPortTimeZone` (string)
    The time zone you want to use for the desired port time.
    Enum: "US/Eastern", "US/Central", "US/Mountain", "US/Pacific"

  - `id` (number)
    The unique identifier for the order
    Example: 890192331

  - `status` (string)
    The current status of the port order.
    Enum: "PENDING", "CONFIRMED", "COMPLETED", "PENDING_CANCELATION", "CANCELED"

  - `customerOrderReference` (string)
    Your reference you specified when creating the order
    Example: "123456"

  - `onDemandActivation` (boolean)
    If you use onDemand activation you will need to make sure the numbers are both confirmed and released for activation, if you don't use onDemand the numbers will be activated on the desiredPortDate is the recommended way.
If true the numbers will be activated as when you call , if false they will be activated on the desiredPortDate

  - `loaUploadedBy` (string)
    Name of the user uploading the LOA
    Example: "john doe"

  - `loaAttachmentDate` (string)
    Date when the LOA was uploaded. Formatted as [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601): .
    Example: "2024-09-24T12:00:00Z"

  - `phoneNumbers` (array)
    The numbers for the order in e164 format

  - `phoneNumbers.phoneNumber` (string, required)
    The phone number in [E.164](https://community.sinch.com/t5/Glossary/E-164/ta-p/7537) format.
    Example: "+12345678901"

  - `phoneNumbers.endUser` (object, required)
    If specified, this will override the endUser for the order.

  - `phoneNumbers.endUser.name` (string, required)
    The name of the end user can be a person's name or company name. Please note if you are not using this yourself it should be the name/company of the actual user.
    Example: "Joe Doe"

  - `phoneNumbers.endUser.streetNum` (string, required)
    The end user's street number.
    Example: "123"

  - `phoneNumbers.endUser.streetName` (string, required)
    The end user's street name.
    Example: "Main"

  - `phoneNumbers.endUser.city` (string, required)
    The end user's city.
    Example: "Anytown"

  - `phoneNumbers.endUser.state` (string, required)
    The end user's state, using the two letter abbreviation.
    Example: "CA"

  - `phoneNumbers.endUser.zipCode` (string, required)
    The end user's zip code.
    Example: "12345"

  - `phoneNumbers.endUser.streetPreDir` (string)
    The prefix direction in the end user's address, if any.
    Example: "N"

  - `phoneNumbers.endUser.streetType` (string)
    The end user's street type, for example Road or Court.
    Example: "Court"

  - `phoneNumbers.endUser.streetPostDir` (string)
    The suffix direction in the end user's address, if any.
    Example: "SW"

  - `phoneNumbers.endUser.locationType1` (string)
    Any additional location information, such as suite or apartment.
    Example: "Suite"

  - `phoneNumbers.endUser.locationValue1` (string)
    Any additional location information, such as suite number or apartment number.
    Example: "2134"

  - `phoneNumbers.endUser.locationType2` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.locationValue2` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.locationType3` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.locationValue3` (string)
    Field for additional location information, such as suite number or apartment number.

  - `phoneNumbers.endUser.typeOfService` (string)
    The type of address. Available values are  for Business or  for Residence
    Enum: "B", "R"

  - `phoneNumbers.portOutInfo` (object, required)
    The port out information at the previous carrier for the number. Usually only a port-out PIN is required.

  - `phoneNumbers.portOutInfo.existingPortOutPin` (string)
    The existing port-out PIN from the previous carrier.

  - `phoneNumbers.portOutInfo.accountNum` (string)
    The account number associated with the number from the previous carrier.

  - `phoneNumbers.portOutInfo.accountPhoneNumber` (string)
    The contact phone number on the account.

  - `phoneNumbers.portOutInfo.authorizingName` (string)
    Name of the person authorizing the port-in.

  - `phoneNumbers.portOutInfo.authorizingDate` (string)
    Date of authorizing the port-in (must be today or earlier and cannot be in the future). Formatted as [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601): .
    Example: "2024-09-24T12:00:00Z"

  - `phoneNumbers.status` (string)
    The porting status of the phone number.
    Enum: "PENDING", "CONFIRMED", "REJECTED", "ACTIVATED", "CANCELED", "EXCLUDED"

  - `phoneNumbers.exclusionReason` (string)
    If the phone number is excluded or rejected, the status here would reflect as such. In this case, there would be an exclusion reason along with date of exclusion.

  - `phoneNumbers.exclusionTime` (string)
    If the phone number is excluded or rejected, this is the date and time it was excluded. This is accompanied by the . Formatted as [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601): .
    Example: "2024-09-24T12:00:00Z"

  - `phoneNumbers.countryCode` (string)
    The ISO 3166-1 formatted country code of the phone number, for example, US or CA. At the moment, only North American numbers are supported.
    Example: "US"

  - `phoneNumbers.activateTime` (string)
    The time the number was activated in the UTC timezone.
    Example: "14:00"

  - `phoneNumbers.activateUser` (string)
    The user that activated the number.

  - `phoneNumbers.voiceConfiguration` (any)

  - `phoneNumbers.smsConfiguration` (object)
    If specified, this will override the sms configuration for the order.

  - `phoneNumbers.smsConfiguration.smsAppId` (string)

  - `phoneNumbers.features` (object)

  - `phoneNumbers.features.e911` (object)
    An object describing the emergency 911 contact address associated with the number.

  - `phoneNumbers.features.e911.name` (string)
    The contact name.

  - `phoneNumbers.features.e911.streetNum` (string)
    The street number for the emergency address.
    Example: "12345"

  - `phoneNumbers.features.e911.streetInfo` (string)
    The street name of the emergency location.
    Example: "Main St"

  - `phoneNumbers.features.e911.location` (string)
    The location for address.
    Example: "Apt 5"

  - `phoneNumbers.features.e911.city` (string)
    The city of the emergency location.
    Example: "Springfield"

  - `phoneNumbers.features.e911.state` (string)
    The state or province of the emergency location.
    Example: "IL"

  - `phoneNumbers.features.e911.postalCode` (string)
    The postal code of the emergency location.
    Example: "62701"

  - `phoneNumbers.features.e911.postalCodePlusFour` (string)
    The postal code of the emergency location.
    Example: "1234"

  - `phoneNumbers.features.e911.enhStreetNum` (string)
    The validated street number.

  - `phoneNumbers.features.e911.enhStreetInfo` (string)
    The validated street.

  - `phoneNumbers.features.e911.enhLocation` (string)
    The validated street location.

  - `phoneNumbers.features.e911.enhCity` (string)
    The validated city.

  - `phoneNumbers.features.e911.enhState` (string)
    The validated state.

  - `phoneNumbers.features.e911.enhPostalCode` (string)
    The validated postal code.

  - `phoneNumbers.features.e911.enhPostalCodePlusFour` (string)
    The validated postal code +4 digits.

  - `phoneNumbers.newPortOutPin` (string)

  - `phoneNumbers.rejectReason` (string)
    The reason the number was rejected.

  - `phoneNumbers.excludedFeatures` (array)
    Features that are excluded for the phone number being ported.

  - `phoneNumbers.excludedFeatures.featureName` (string)
    The name of the excluded feature.

  - `phoneNumbers.excludedFeatures.exclusionReason` (string)
    The reason the feature was excluded.

  - `phoneNumbers.phoneNumberGroup` (string)
    Example: "GW Verizon Grp1"

  - `phoneNumbers.focDate` (string)
    Once the phone number has a firm order confirmation (FOC) date, it will be returned as part of the phone number details. Formatted as [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601): .
    Example: "2024-09-24T12:00:00Z"

  - `notes` (array)
    Notes if any on the order, you will get notes if there is any problems with the order and you send notes as reply to those problems

  - `notes.note` (string)
    The message of the note.

  - `notes.createdTime` (string)
    The date and time when the note was created in UTC ISO https://www.ietf.org/rfc/rfc3339.txt.

  - `notes.createdBy` (string)
    The user who created the note.

  - `documents` (array)
    Documents if any on the order, you will get documents if there is any problems with the order and you send documents as reply to those problems

  - `documents.id` (number)
    The ID of the order document.

  - `documents.documentName` (string)
    The name of the document.

  - `documents.description` (string)
    A description of the contents of the document.

  - `createdDate` (string)
    When the order was created. Formatted as [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601): .
    Example: "2024-09-24T12:00:00Z"

  - `resellerName` (string)