## 🎉ShipEngine is becoming ShipStation API🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our [New ShipStation API page](/content/docs/new-shipstation-api/index.html).

# Update a Carrier Connection

Certain carriers allow you to update your account authentication details via ShipStation API without [deleting the carrier](/content/docs/reference/carriers/delete-carrier/index.html) and reconnecting it. This is useful if you've updated your carrier account password, API key, or other related credentials.

## Requirements

- The `carrier_id` and `carrier_name` for the account you wish to update (you can use the [List Carriers](/content/docs/reference/list-carriers/index.html) endpoint to gather this informaiton)
- The details for the properties you wish to update for that carrier (will vary by carrier)

> **INFO:**  
> Not all carriers allow updating their connections using this method.  
> For carriers that do not support updating the connection in this way, you'll need to [delete the carrier](/content/docs/reference/carriers/delete-carrier/index.html) and [reconnect it](/content/docs/carriers/connect/index.html) with your updated account details.

## Example Request & Response

Updating your carrier authentication details uses the following method and endpoint:

**PUT /v1/connections/carriers/:carrier_name/:carrier_id**

This example updates a Stamps.com account nickname, username, and password.

```
PUT /v1/connections/carriers/stamps_com/se-12345678 HTTP/1.1

{
      "nickname": "new nickname",
      "username": "newusername",
      "password": "supersecretpassword"
}
```

No matter which carrier you are updating, the response will return the `carrier_id`.

```
{
  "carrier_id": "se-12345678"
}
```

## Supported Carriers

You can update the carrier authentication details listed for the following carriers:

### Chronopost

| Property | Type | Description |
| --- | --- | --- |
| `nickname` | _string_ | **required** |
| `account_number` | _string_ | **required** |
| `password` | _string_ | **required** |
| `injection_address_heading` | object |  |
| `title` | _string_ | Max length: 13 characters |
| `name` | _string_ | Max length: 100 characters |
| `company` | _string_ | Max length: 100 characters |
| `address1` | _string_ | Max length: 38 characters |
| `address2` | _string_ | Max length: 38 characters |
| `city` | _string_ | Max length: 50 characters |
| `postal_code` | _string_ | Max length: 9 characters |
| `country` | _string_ | Max length: 2 characters |
| `contact_name` | _string_ | Max length: 100 characters |
| `email` | _string_ | Max length: 80 characters |
| `phone` | _string_ | Max length: 17 characters |

### Colissimo

| Property | Type | Description |
| --- | --- | --- |
| `nickname` | _string_ | **required** |
| `username` | _string_ | **required** |
| `password` | _string_ | **required** |

### Endicia

| Property | Type | Description |
| --- | --- | --- |
| `nickname` | _string_ | **required** |
| `account` | _string_ | **required** |
| `passphrase` | _string_ | **required** |

### Mondial Relay

| Property | Type | Description |
| --- | --- | --- |
| `nickname` | _string_ | **required** |
| `api_key` | _string_ | **required**<br> Minimum length: 8 characters |
| `enseigne` | _string_ | **required** |

### Stamps.com

### UPS

| Parameter | Type | Description |
| --- | --- | --- |
| `nickname` | _string_ | **required** |
| `is_primary_account` | boolean | Indicates the account is or is not the default account. |
| `pickup_type` | _enumerated string_ | `daily_pickup`, `occasional_pickup`, `customer_counter`<br> See our [Intro to Pickup Dropoff page](/content/docs/pick-up-drop-off/pudo-intro/index.html) to learn more. |
| `use_carbon_neutral_shipping_program` | boolean | Adds a fee to the shipment to purchase carbon offset credits. |
| `use_ground_freight_pricing` | boolean | An advanced option available for certain UPS services. See our [UPS Ground Freight page](/content/docs/shipping/ups-ground-freight/index.html) for more details. |
| `use_consolidation_services` | boolean | Enable the use of UPS Mail Innovations® and Ground Saver® services. |
| `use_order_number_on_mail_innovations_labels` | boolean |  |
| `mail_innovations_endorsement` | _enumerated string_ | `return_service_requested``forwarding_service_requested``address_service_requested``change_service_requested``leave_if_no_response` |
| `mail_innovations_cost_center` | _string_ |  |
| `use_negotiated_rates` | boolean | If your account has been approved for negotiated rates, you can enable this option to use those rates. Once enabled, negotiated rates cannot be disabled. |
| `account_postal_code` | _string_ | **Required** |
| `invoice` | string |  |
| `mail_innovations_customer_id` | _string_ | **Required** to get rates for MI services. Also known as UPS MI account number. |
| `mail_innovations_customer_guid` | _string_ | **Required** to get rates for MI services. Also known as a rate key. |
| `account_country_code` | _string_ | **Required** 2-character country code associated with the account. |
| `account_number` | _string_ |  |

We will update this list as this method becomes available for more carriers.