Every user of your SaaS who wants to connect integrations must exist as an end user inside MindCloud. Each end user maps one-to-one with a user in your platform.
You should create the end user once—typically when they first sign up or the first time they visit your integrations page. Store the returned userId in your database so you can reference it later.
Use your own unique identifier (externalId) for mapping.
Only call createUser once per SaaS user.
Reuse the same end user object for all future operations (credentials, integrations, workflows).
After creating an end user from your backend, you will then authenticate the Client SDK as that user.
Example cURL
curl -X POST "https://embedded.mindcloud.co/v1/users" \
-H "Authorization: Bearer <API Key>" \
-H "Content-Type: application/json" \
-d '{
"externalId": "12345",
"name": "Jane Doe",
"email": "customer@example.com"
}'Response:
{
"success": true,
"data": {
"userId": "enduser_12345"
}
}