> For the complete documentation index, see [llms.txt](https://dev.hybrid-chain.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.hybrid-chain.com/api-docs/core-functionality/authentication/auth-register-a-user.md).

# AUTH: Register a User

This end-point allows a new private user to be registered/signed-up.

{% hint style="info" %}
Please see the "Register a Corporate User" Endpoint for companies/corporations.
{% endhint %}

{% hint style="info" %}
The country\_code is an optional field that can be used to submit the 2-digit international country code. This may help potential KYC providers on assessing the risk-scoring system and other parameters. (Note: use the General/Countries endpoint to get a list of all valid countries).
{% endhint %}

{% hint style="info" %}
Using the ref-code ensures that the user is correctly linked to the corresponding referring user (it can be left blank or ignored).
{% endhint %}

{% hint style="warning" %}
The Whitelabel Hash is used to assign the user to the corresponding whitelabel. if left blank, the registered user will automatically become a native Hybrid-Chain user.
{% endhint %}

{% hint style="warning" %}
**The ref-code CANNOT be changed or amended.**
{% endhint %}

{% hint style="info" %}
The Unique User Identifier can either be the email address (specified with the 'email' parameter), or an international phone number (in the +XXX format (eg. +18228923310), specified with the 'msisdn' parameter). *Only one of the two identifiers can be submitted per request.*
{% endhint %}

## AUTH: Register a Corporate User

> This end-point allows a new corporate user to be registered/signed-up (please see the "Register a Private User" Endpoint for more details on the parameters and payload).

```json
{"openapi":"3.0.0","info":{"title":"Hybrid-Chain API Documentation and Specification","version":"1.0.0"},"servers":[{"url":"https://api.hybrid-chain.com/api/v1"}],"paths":{"/auth/registration":{"post":{"tags":["Authentication"],"summary":"AUTH: Register a Corporate User","description":"This end-point allows a new corporate user to be registered/signed-up (please see the \"Register a Private User\" Endpoint for more details on the parameters and payload).","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"OK","headers":{"Server":{"schema":{"type":"string"}},"Date":{"schema":{"type":"string"}},"Content-Type":{"schema":{"type":"string"}},"Content-Length":{"schema":{"type":"integer"}},"Connection":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}},"Access-Control-Allow-Origin":{"schema":{"type":"string"}},"Vary":{"schema":{"type":"string"}},"Strict-Transport-Security":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://dev.hybrid-chain.com/api-docs/core-functionality/authentication/auth-register-a-user.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.