Create a customer manually

POST

https://numueg.app/api/v1/stores/{store_id}/customers/

Last modified:2026-09-19 16:39:33

x-numu-scope:customers:write

Create a customer on behalf of the merchant (no login credentials).

Mirrors Shopify's admin "Add customer": the record exists for orders,
marketing, and segmentation. If the person later registers on the
storefront with the same email, that flow sets their password on a
separate row check — this endpoint rejects duplicate emails outright.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//customers/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accepts_marketing": true,
    "email": "ahmed@example.com",
    "first_name": "Ahmed",
    "last_name": "Hassan",
    "location": "Cairo",
    "notes": "VIP — met at the Cairo pop-up",
    "phone": "+201234567890",
    "tags": [
        "vip",
        "wholesale"
    ]
}'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "accepts_marketing": true,
        "created_at": "2025-01-05T09:00:00Z",
        "email": "ahmed@example.com",
        "first_name": "Ahmed",
        "full_name": "Ahmed Hassan",
        "id": "990e8400-e29b-41d4-a716-446655440000",
        "is_verified": true,
        "last_name": "Hassan",
        "phone": "+201234567890",
        "store_id": "660e8400-e29b-41d4-a716-446655440000",
        "total_orders": 5,
        "total_spent": 125000,
        "updated_at": "2025-02-10T14:00:00Z"
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

List store customers

Get customer by ID