Create a new customer
const url = 'https://open-api.replyco.com/openapi/customer';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json-patch+json'}, body: '{ "integrationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "marketplace": "0 - PlaceholderDoNotUse", "firstName": "Jane", "lastName": "Smith", "email": "jane.smith@example.com", "phone": "+44 7911 123456", "marketCustomerId": "ebay-buyer-jane99", "customerAddress": { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "addressLine1": "example", "addressLine2": "example", "addressLine3": "example", "city": "example", "country": "example", "postalCode": "example", "state": "example", "phone": "example" }, "notes": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "note": "example", "username": "example" } ] }'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://open-api.replyco.com/openapi/customer \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json-patch+json' \ --data '{ "integrationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "marketplace": "0 - PlaceholderDoNotUse", "firstName": "Jane", "lastName": "Smith", "email": "jane.smith@example.com", "phone": "+44 7911 123456", "marketCustomerId": "ebay-buyer-jane99", "customerAddress": { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "addressLine1": "example", "addressLine2": "example", "addressLine3": "example", "city": "example", "country": "example", "postalCode": "example", "state": "example", "phone": "example" }, "notes": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "note": "example", "username": "example" } ] }'Creates a new customer record in the system for the authenticated user’s company.
Required fields:
integrationId— the marketplace account this customer belongs tomarketplace— the channel or marketplace type; use20for custom integrations
Matching and de-duplication:
Provide marketCustomerId whenever possible — this is the buyer’s unique ID on the
marketplace (e.g. eBay username, Shopify customer ID) and is used internally to match
and de-duplicate customers when threads arrive from that marketplace.
Address: All address sub-fields are optional. Provide as many as are available.
Notes:
Each note entry requires at minimum the note text field.
The username field will be auto-populated when left empty.
Sample request:
POST /customer
{
"integrationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"marketplace": 20,
"firstName": "Jane",
"lastName": "Smith",
"email": "jane.smith@example.com",
"phone": "+44 7911 123456",
"marketCustomerId": "ebay-buyer-jane99",
"customerAddress": {
"addressLine1": "221B Baker Street",
"city": "London",
"postalCode": "NW1 6XE",
"country": "GB"
},
"notes": [
{ "note": "VIP customer — handle with priority." }
]
}Authorizations
Section titled “Authorizations”Request Body
Section titled “Request Body”Customer data. Only integrationId and marketplace are required.
Input model for creating a new customer.
IntegrationId and Marketplace are required — all other fields are optional
but should be filled in with as much detail as is available to make the customer identifiable.
object
ID of the integration (marketplace account) this customer belongs to. Find this on the Integrations page inside your Replyco account.
Example
3fa85f64-5717-4562-b3fc-2c963f66afa6Customer’s first name.
Example
JaneCustomer’s last name.
Example
SmithCustomer’s email address. Used for search and communication linking inside Replyco.
Example
jane.smith@example.comCustomer’s phone number (any format accepted).
Example
+44 7911 123456The customer’s unique ID as it appears on the marketplace (e.g. eBay buyer username, Shopify customer ID). Used to match and de-duplicate customers when syncing from your platform.
Example
ebay-buyer-jane99object
State or region
Internal notes to attach to the customer record (e.g. VIP flag, special handling instructions).
Each note requires at minimum the note text field.
object
Input model for creating a new customer.
IntegrationId and Marketplace are required — all other fields are optional
but should be filled in with as much detail as is available to make the customer identifiable.
object
ID of the integration (marketplace account) this customer belongs to. Find this on the Integrations page inside your Replyco account.
Example
3fa85f64-5717-4562-b3fc-2c963f66afa6Customer’s first name.
Example
JaneCustomer’s last name.
Example
SmithCustomer’s email address. Used for search and communication linking inside Replyco.
Example
jane.smith@example.comCustomer’s phone number (any format accepted).
Example
+44 7911 123456The customer’s unique ID as it appears on the marketplace (e.g. eBay buyer username, Shopify customer ID). Used to match and de-duplicate customers when syncing from your platform.
Example
ebay-buyer-jane99object
State or region
Internal notes to attach to the customer record (e.g. VIP flag, special handling instructions).
Each note requires at minimum the note text field.
object
Input model for creating a new customer.
IntegrationId and Marketplace are required — all other fields are optional
but should be filled in with as much detail as is available to make the customer identifiable.
object
ID of the integration (marketplace account) this customer belongs to. Find this on the Integrations page inside your Replyco account.
Example
3fa85f64-5717-4562-b3fc-2c963f66afa6Customer’s first name.
Example
JaneCustomer’s last name.
Example
SmithCustomer’s email address. Used for search and communication linking inside Replyco.
Example
jane.smith@example.comCustomer’s phone number (any format accepted).
Example
+44 7911 123456The customer’s unique ID as it appears on the marketplace (e.g. eBay buyer username, Shopify customer ID). Used to match and de-duplicate customers when syncing from your platform.
Example
ebay-buyer-jane99object
State or region
Internal notes to attach to the customer record (e.g. VIP flag, special handling instructions).
Each note requires at minimum the note text field.
object
Input model for creating a new customer.
IntegrationId and Marketplace are required — all other fields are optional
but should be filled in with as much detail as is available to make the customer identifiable.
object
ID of the integration (marketplace account) this customer belongs to. Find this on the Integrations page inside your Replyco account.
Example
3fa85f64-5717-4562-b3fc-2c963f66afa6Customer’s first name.
Example
JaneCustomer’s last name.
Example
SmithCustomer’s email address. Used for search and communication linking inside Replyco.
Example
jane.smith@example.comCustomer’s phone number (any format accepted).
Example
+44 7911 123456The customer’s unique ID as it appears on the marketplace (e.g. eBay buyer username, Shopify customer ID). Used to match and de-duplicate customers when syncing from your platform.
Example
ebay-buyer-jane99object
State or region
Internal notes to attach to the customer record (e.g. VIP flag, special handling instructions).
Each note requires at minimum the note text field.
object
Responses
Section titled “Responses”Customer created successfully — returns the full customer model.
IntegrationId and ShopType are required.
object
object
State or region
Related Notes to Customer
object
Example
{ "marketplace": "0 - PlaceholderDoNotUse"}Request validation failed (missing required fields or malformed body).
Missing or invalid authentication token.