merce.STACK
merce.STACK
Skip to content
PricingWhat's new
Log inGet started
{}Developers
GuidesAPI referenceChangelogGet API keys →
  • Get started

    • Quickstart
    • Keys & authentication
  • Storefront

    • Products & catalog
    • Carts
    • Checkout & payment
    • Customer accounts
    • Digital products
    • Without a build step
    • Bookings
    • Courses
    • Drop-in components
  • Server API

    • Server API
    • Customers
    • Payment links & transactions
    • Balance & payouts
    • Classes & students
    • Node SDK
  • Email API

    • Email API
    • Sending email
    • Delivery events
  • Events & errors

    • Webhooks
    • Errors
  • Reference

    • API reference
    • Changelog

Server API

Customers

The people and companies in your CRM — including shoppers and students.

One customer record per person or company. Store shoppers, paying students and people you add by hand all land here, so your backend sees one list.

List customers

GET/v1/customers
Secret keycustomers:read

Newest first.

Query parameters

limitinteger
How many to return, 1–100. Defaults to 25.
cursorstring
nextCursor from the previous page.
emailstring
Exact email, any case.
statusstring
prospect, active, inactive…
curl https://api.mercestack.com/v1/customers?limit=10 \
  -H "Authorization: Bearer sk_test_…"
Response
{
  "object": "list",
  "data": [
    {
      "id": "7e1f…",
      "name": "Chidi Okeke",
      "kind": "person",
      "email": "[email protected]",
      "phone": null,
      "status": "active",
      "tags": ["student"],
      "address": null,
      "createdAt": "2026-09-27T10:00:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Get a customer

GET/v1/customers/:id
Secret keycustomers:read

With contacts and deals.

curl https://api.mercestack.com/v1/customers/CUSTOMER_ID \
  -H "Authorization: Bearer sk_test_…"
Response
{ "id": "7e1f…", "name": "Chidi Okeke", "contacts": [], "deals": [], … }

Create a customer

POST/v1/customers
Secret keycustomers:write

Fires customer.created.

Body

namestringrequired
2–200 characters.
kind"person" | "company"
Defaults to company.
emailstring
Email address.
phonestring
Phone number.
statusstring
Defaults to prospect.
tagsstring[]
Free-form labels.
curl -X POST https://api.mercestack.com/v1/customers \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Chidi Okeke","kind":"person","email":"[email protected]"}'
Response
{ "id": "7e1f…", "name": "Chidi Okeke", … }

Update a customer

PATCH/v1/customers/:id
Secret keycustomers:write

Send the fields to change. name is required.

curl -X PATCH https://api.mercestack.com/v1/customers/CUSTOMER_ID \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Chidi Okeke","status":"active"}'
Response
{ "id": "7e1f…", "status": "active", … }
← PreviousServer APINext →Payment links & transactions

On this page

  • GETList customers
  • GETGet a customer
  • POSTCreate a customer
  • PATCHUpdate a customer
Create a workspaceTalk to usPricing

One workspace for everything your business runs on — your team, customers, store, marketing and payouts in one place.

Get started

Product

  • All products
  • Pricing
  • What's new
  • Security

Resources

  • Documentation
  • Guides
  • Use cases
  • Blog
  • Get support

Company

  • About
  • Careers
  • Contact us
  • Talk to the team

Legal

  • Privacy
  • Terms
  • Cookie policy
  • GDPR
  • Report a vulnerability

© 2026 Mercestack. All rights reserved.

Mercestack StructureOS

mercestack