Add a User to Stytch. A `user_id` is returned in the response that can then be used to perform other operations within Stytch. An `email` or a `phone_number` is required.
Stytch Consumer Users Create Example is an example object payload from Stytch, with 5 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
{
"title": "Create",
"endpoint": "POST /v1/users",
"description": "Add a User to Stytch. A `user_id` is returned in the response that can then be used to perform other operations within Stytch. An `email` or a `phone_number` is required.",
"request": {
"method": "POST",
"path": "/v1/users",
"headers": {
"Authorization": "Basic <base64(project_id:secret)>",
"Content-Type": "application/json"
},
"body": {
"email": "<email>",
"phone_number": "<phone_number>",
"create_user_as_pending": true,
"trusted_metadata": {},
"untrusted_metadata": {},
"external_id": "<external_id>",
"roles": []
}
},
"response": {
"status": 200,
"body": {
"request_id": "example-value",
"user_id": "example-value",
"email_id": "example-value",
"status": "example-value",
"phone_id": "example-value",
"status_code": 200
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.