---
title: Register
description: "The Profile Register API allows you to send information about newly registered profiles to Releva. Unlike the [Profile Update API](https://releva.ai/documentation/profile-update/), this API should be called at the time a user completes their registration. **Imporant: If you have a \"subscribe to…"
url: "https://releva.ai/documentation/profiles-2/profile-register/"
updated: "2026-09-22"
category: Developer Documentation / Profiles
---

# Register

The Profile Register API allows you to send information about newly registered profiles to Releva. Unlike the [Profile Update API](https://releva.ai/documentation/profile-update/), this API should be called at the time a user completes their registration.

**Imporant: If you have a "subscribe to marketing" checkbox on your user registration page, please also call the [Profile Subscribe API](https://releva.ai/documentation/third-party-integration-apis/subscribe/) to mark the newly created users as subscribed.** Alternatively, call the [Profile Update API](https://releva.ai/documentation/profile-update/) to send us a subscribe date and a registration date with a single request.

### Request Parameters

You may perform requests to the API using the following curl equivalent:

```js
curl -H 'Content-Type: application/json' -H 'Authorization: Bearer <secretKey>' -XPOST https://releva.ai/api/v0/register -d'{
    "id": "custId1234",
    "email": "info@releva.ai",
    "firstName": "Georgi",
    "lastName": "Georgiev",
    "phoneNumber": "+359....",
    "tags": [
        "availabe",
        "acceptingMessages"
    ],
    "birthday": "1989-11-15"
}'
```

### The *profile* Object

| Field | Type | Description |
| --- | --- | --- |
| **id** | String | User's unique identifier in your database |
| **email** | String (Optional) | User’s email address. |
| **phoneNumber** | String (Optional) | User's phones number. Phone numbers must start with “+” followed by numbers only. Valid phone number: +49875345976. |
| **firstName** | String (Optional) | User’s first name. |
| **lastName** | String (Optional) | User’s last name. |
| **tags** | Array[String] (Optional) | Tags to apply to the user. |
| **birthday** | [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) String **(date without time) **(Optional) | The users’s birthday |

A successful response will return HTTP Status **202** with an empty response body (**{}**).

### Response Format

An error response will return a HTTP **4xx** or **5xx** status code and have the following structure:

```js
{
  "message": "A description of the error and how to fix it, if it's a client error."
}
```