Update customer contact

POST

/merchants/{merchantCode}/customers/{customerId}/contacts/{contactId}

curl --request POST \
  --url https://customer.shopgate.io/v1/merchants/example/customers/example/contacts/example \
  --header 'Content-Type: application/json' \
  --data '{ "externalContactCode": "357709b0-9378-470b-976e-1b040e29b97b", "status": "active", "firstName": "John", "middleName": "Doug", "lastName": "Doe", "companyName": "Shopgate Inc", "address1": "12 Somestreet", "address2": "", "address3": "", "address4": "", "city": "Austin", "postalCode": "78732", "region": "TX", "country": "US", "additionalFields": { "dhlPostBoxNumber": "example", "dhlPostNumber": "example" }, "phone": "000-000-0000", "fax": "000-000-0000", "mobile": "000-000-0000", "emailAddress": "somelocation@someRetailer.com", "isDefaultShipping": false, "isDefaultBilling": false, "externalUpdateDate": "2026-04-15T12:00:00Z" }'

Update customer contact

Parameters

Path Parameters

merchantCode

required

string

customerId

required

string

contactId

required

string

Request Body

Media typeapplication/json

object

externalContactCode

External identifier of the contact

string | null

Example

357709b0-9378-470b-976e-1b040e29b97b

status

string

default: active

Allowed values: active inactive deleted

Example

active

firstName

string

Example

John

middleName

string | null

Example

Doug

lastName

string

Example

Doe

companyName

string | null

Example

Shopgate Inc

address1

string

Example

12 Somestreet

address2

string | null

Example

address3

string | null

Example

address4

string | null

Example

city

string

Example

Austin

postalCode

string

Example

78732

region

string

Example

TX

country

string

Example

US

additionalFields

object

dhlPostBoxNumber

Number of a postbox

string | null

>= 1 characters <= 5 characters

dhlPostNumber

Number of a post

string | null

>= 1 characters <= 10 characters

phone

Validated according to country code

string | null

Example

000-000-0000

fax

Validated according to country code

string | null

Example

000-000-0000

mobile

Validated according to country code

string | null

Example

000-000-0000

emailAddress

string format: email

Example

somelocation@someRetailer.com

isDefaultShipping

boolean

Example

true

isDefaultBilling

boolean

Example

true

externalUpdateDate

string format: date-time

Responses

204

Contact successfully updated

Media typeapplication/json

400

Invalid contact type passed

Media typeapplication/json

404

Merchant, customer or contact not found

Media typeapplication/json

default

Unexpected error

Media typeapplication/json

object

code

Machine readable error code

string

message

required

Human readable error code

string

Example^generated

{
  "code": "example",
  "message": "example"
}