---
title: "Upsert customer external ID"
method: POST
path: "/v3/customers/{id}/external-ids"
tags: ["Customers"]
---

# Upsert customer external ID

`POST /v3/customers/{id}/external-ids`

## Path parameters

- `id` string, required

## Request body

- UpsertCustomerExternalIdV3Dto
  - `externalId` string, required — External identifier value
  - `sourceType` 'QUICKBOOKS' | 'NETSUITE' | 'RILLET' | 'SAGE_INTACCT' | 'SALESFORCE' | 'HUBSPOT' | 'AVALARA' | 'ANROK' | 'STRIPE', required

## Response `200`

Customer external ID upserted successfully

- object
  - `payload` UpsertCustomerExternalIdV3Dto
    - `externalId` string, required — External identifier value
    - `sourceType` 'QUICKBOOKS' | 'NETSUITE' | 'RILLET' | 'SAGE_INTACCT' | 'SALESFORCE' | 'HUBSPOT' | 'AVALARA' | 'ANROK' | 'STRIPE', required

## Other responses

- `400` — Bad request
- `404` — Customer not found

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)