Create an entrepreneur
/entrepreneursCreates an entrepreneur, a hidden Opportunity Provider organisation your organisation owns, with its primary contact as a user in Pending status, and returns it with a Location. name defaults to label; a name another organisation holds, or a contact_email another user holds, returns 422 unique. No invitation is sent and none is created; the contact cannot sign in until invited. Emits entrepreneur.created. dry_run validates and shows the result without creating anything. It can't be undone, and an entrepreneur cannot be deleted.
Query parameters
Validate and run the call without committing it, returning what the real call would return with
meta.dry_runset.
Headers
Makes a retry safe. Send a new UUID for each new request and reuse it only to retry that request; the first response is replayed for 24 hours.
Request body
application/json, required · EntrepreneurCreate
The display name.
The internal name. Defaults to
label. A name another organisation holds returns 422unique.The entrepreneur's website.
Where the entrepreneur is based.
The primary contact's email, which becomes their sign-in username. An email another user holds returns 422
unique.The primary contact's first name.
The primary contact's last name.
The primary contact's title, such as Ms or Dr.
{
"label": "Acme Ventures",
"website": "https://acme.example.com",
"headquarters": "London, UK",
"contact_email": "founder@acme.example.com",
"contact_first_name": "Grace",
"contact_last_name": "Hopper",
"contact_title": "Ms"
}Responses
{
"data": {
"id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
"name": "string",
"label": "string",
"email": "string",
"website": "string",
"headquarters": "string",
"created_at": "2026-06-12T10:00:00+00:00",
"updated_at": "2026-06-12T10:00:00+00:00",
"contact": {
"id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
"first_name": "string",
"last_name": "string",
"email": "string",
"status": "string"
}
}
}Authorization failed. error.code is one of org_disabled,
ip_blocked, missing_scope, scope_disabled, user_disabled.
The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per
problem, or a code documented on the operation.
Examples
curl -X POST https://your-org-domain/kong/core/api/v2/entrepreneurs\
-H "Authorization: Bearer $HELM_API_KEY"\
-H "Content-Type: application/json"\
-d '{
"label": "Acme Ventures",
"website": "https://acme.example.com",
"headquarters": "London, UK",
"contact_email": "founder@acme.example.com",
"contact_first_name": "Grace",
"contact_last_name": "Hopper",
"contact_title": "Ms"
}'