Create Contact

POST

https://getrasl.io/api/v2/contacts

Create a new contact in your tenant account

Required Scope

contacts:write

Feature Limits

This endpoint respects tenant feature limits for contacts. If the limit is reached, a FEATURE_LIMIT_EXCEEDED error is returned with details about current usage and maximum allowed

Response

Success (201 Created): Returns the created contact data wrapped in ContactResource format with groups auto-loaded. Includes message: "Contact created successfully"

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Example

{
    "firstname": "string",
    "lastname": "string",
    "phone": "+201XXXXXXXXX",
    "type": "lead",
    "source_id": 0,
    "status_id": 0,
    "email": "user@example.com",
    "company": "string",
    "description": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "address": "string",
    "country_id": 0,
    "assigned_id": 0,
    "groups": [
        0
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://getrasl.io/api/v2/contacts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstname": "string",
    "lastname": "string",
    "phone": "+201XXXXXXXXX",
    "type": "lead",
    "source_id": 0,
    "status_id": 0,
    "email": "user@example.com",
    "company": "string",
    "description": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "address": "string",
    "country_id": 0,
    "assigned_id": 0,
    "groups": [
        0
    ]
}'

Responses

🟢201Success

application/json

Body

Example

{
    "success": true,
    "data": {},
    "meta": {
        "request_id": "string",
        "timestamp": "string"
    }
}

🟠401UNAUTHORIZED

🟠403INSUFFICIENT_SCOPE

🟠403FEATURE_LIMIT_EXCEEDED

🟠404NOT_FOUND

🟠422VALIDATION_ERROR

🟠422WHATSAPP_NOT_CONFIGURED

🟠429RATE_LIMIT_EXCEEDED

🔴500INTERNAL_ERROR

List Contacts

Get Contact

Create Contact

Create a new contact in your tenant account#

Required Scope#

Feature Limits#