Update Contact Information

PUT

https://getrasl.io/api/v1/{tenant-name}/contacts/{id}

Modify an existing contact's details with full validation and group management

This endpoint allows you to update any contact field while maintaining data integrity.

Key Features

Update any contact field individually or in bulk

Automatic validation with unique email/phone checks

Group assignment with auto-creation

Contact type conversion (lead to customer)

Maintains audit trail with timestamps

Business Rules

Email must remain unique within the tenant (if changed)

Phone must remain unique within the tenant (if changed)

Groups will be auto-created if they don't exist

Original contact ID and tenant cannot be changed

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Header Params

Body Params application/jsonRequired

Example

{
  "firstname": "Mahmoud",
  "lastname": "Elsayed",
  "company": "RASL",
  "type": "customer",
  "email": "mahmoud@example.com",
  "phone": "+201XXXXXXXXX",
  "source_id": 2,
  "status_id": 3,
  "description": "Updated client status after successful meeting, moved to active customer",
  "country_id": 101,
  "groups": "Active Customers,Premium Support,Monthly Newsletter"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://getrasl.io/api/v1//contacts/25' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "firstname": "Mahmoud",
  "lastname": "Elsayed",
  "company": "RASL",
  "type": "customer",
  "email": "mahmoud@example.com",
  "phone": "+201XXXXXXXXX",
  "source_id": 2,
  "status_id": 3,
  "description": "Updated client status after successful meeting, moved to active customer",
  "country_id": 101,
  "groups": "Active Customers,Premium Support,Monthly Newsletter"
}'

Responses

🟢200Success

application/json

Body

Example

{
  "status": "success",
  "message": "Contact updated successfully",
  "data": {
    "id": 25,
    "tenant_id": 13,
    "firstname": "Mahmoud",
    "lastname": "Elsayed",
    "company": "RASL",
    "type": "customer",
    "email": "mahmoud@example.com",
    "phone": "+201XXXXXXXXX",
    "source_id": 2,
    "status_id": 3,
    "description": "Updated client status after successful meeting",
    "country_id": 101,
    "group_id": [
      1,
      2,
      3
    ],
    "addedfrom": 15,
    "created_at": "2024-02-08T14:30:25.000000Z",
    "updated_at": "2024-02-08T16:45:30.000000Z"
  }
}

🟠400Bad Request

🟠401Unauthenticated

🟠404Not Found

🟠422Validation Errors

Get Contact Details

Delete Contact