---
title: "Update shipping contacts"
method: PUT
path: "/customers/{id}/shipping_contacts/{shipping_contacts_id}"
tags: ["Shipping Contacts"]
---

# Update shipping contacts

`PUT /customers/{id}/shipping_contacts/{shipping_contacts_id}`

## Request

- Base URL: `https://api.conekta.io`
- URL: `https://api.conekta.io/customers/{id}/shipping_contacts/{shipping_contacts_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conekta/apis/conekta-api/docs/customers/:id/shipping_contacts/:shipping_contacts_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Update shipping contact that corresponds to a customer ID.

## Path parameters

- `id` string, required
- `shipping_contacts_id` string, required

## Headers

- `Accept-Language` 'es' | 'en'
- `X-Child-Company-Id` string

## Request body

- CustomerUpdateShippingContactsRequest: [Shipping](https://developers.conekta.com/v2.3.0/reference/createcustomershippingcontacts) details, required in case of sending a shipping. If we do not receive a shipping_contact on the order, the default shipping_contact of the customer will be used.
  - `phone` string: Phone contact
  - `receiver` string: Name of the person who will receive the order
  - `between_streets` string: The street names between which the order will be delivered. Must contain at least two consecutive ASCII letters.
  - `address` ShippingContactAddress: Address of the person who will receive the order
    - `street1` string: Street and number of the delivery address.
    - `street2` string: Apartment, suite or interior reference for the delivery address.
    - `postal_code` string: Postal code of the delivery address. For Mexican addresses (country MX) it must be a 5-digit postal code.
    - `city` string: City of the delivery address. Must contain at least two consecutive ASCII letters.
    - `state` string: State of the delivery address.
    - `country` string: Country of the delivery address. This field follows the [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    - `residential` boolean, nullable: Indicates whether the delivery address is residential.
  - `parent_id` string
  - `default` boolean, nullable
  - `deleted` boolean, nullable

## Response `200`

successful operation

- CustomerShippingContactsResponse: Contains the detail of the shipping addresses that the client has active or has used in Conekta
  - `phone` string
  - `receiver` string
  - `between_streets` string, nullable
  - `address` CustomerShippingContactsAddress
    - `object` string
    - `street1` string
    - `street2` string
    - `postal_code` string
    - `city` string
    - `state` string
    - `country` string
    - `residential` boolean, nullable
  - `parent_id` string
  - `default` boolean
  - `id` string
  - `created_at` integer
  - `metadata` object: Metadata associated with the shipping contact
  - `object` string
  - `deleted` boolean

## Other responses

- `401`: authentication error
- `404`: not found entity
- `422`: parameter validation error
- `500`: internal server error

## Changes

- **2026-11-03** `52f4c0dd8a1b`: 4 breaking, 7 warning, 1 info
  - the `address/country` request property's minLength was increased from `0` to `2`
  - the `address/street1` request property's minLength was increased from `0` to `2`
  - added the pattern `[A-Za-z]{2}` to the request property `address/city`
  - added the pattern `[A-Za-z]{2}` to the request property `between_streets`
  - …8 more

[Operation history](https://skmtc.dev/conekta/apis/conekta-api/changes/customers/:id/shipping_contacts/:shipping_contacts_id/put.md)

---

[API](https://skmtc.dev/conekta/apis/conekta-api.md) - [All operations](https://skmtc.dev/conekta/apis/conekta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conekta/apis/conekta-api/revisions/52f4c0dd8a1b?raw)