Deprecation Notice

This version (v1) will be removed by 31 March 2026.

Contact Lists

Retrieve Contact Lists

Retrieve all the contact lists associated with the logged in user.

GET /integrations/contact-list/

Headers

Name	Value
Authorization	Bearer Access Token

Query Parameters

Name	Type	Required	Description
email	string	Yes	Email of FreJun user
list_id	string	No	Contact List ID (retrieves all lists of the user if not provided)

Response

{
 "success": true,
 "message": "Successfully retrieved contacts lists for mail@gmail.com",
 "data": [
  {
   "id": 100,
   "title": "CONTACT LIST",
   "total_contacts": 10,
   "assigned_contacts": 0,
   "created_at": "2025-04-10T17:54:54.566061",
   "updated_at": "2025-04-10T17:54:54.566085"
  }
 ]
}

Create Contact List

Create a new contact list.

POST /integrations/contact-list/

Headers

Name	Value
Authorization	Bearer Access Token
Content-Type	application/json

Payload

user required	string <email> Email of FreJun user
title required	string Title of the contact list
required	Array of objects (ContactItem) List of contacts to add to the contact list

Response

{
 "success": true,
 "message": "Request successfully submitted for creating Contact list",
 "contact_list_id": "abc123def456"
}

Update Contact List

Update an existing contact list.

PATCH /integrations/contact-list/

Headers

Name	Value
Authorization	Bearer Access Token
Content-Type	application/json

Payload

email	string <email> Email of FreJun user
list_id	string Contact List ID
	Array of objects (ContactOperation) List of contact operations to perform

Response

{
 "success": true,
 "message": "Request successfully submitted for updating Contact list"
}

Delete Contact List

Delete a contact list.

DELETE /integrations/contact-list/

Headers

Name	Value
Authorization	Bearer Access Token

Query Parameters

Name	Type	Required	Description
email	string	Yes	Email of FreJun user
list_id	string	Yes	Contact List ID

Assign Contacts

Assign contacts to a user.

PATCH /integrations/assign-contact/

Headers

Name	Value
Authorization	Bearer Access Token
Content-Type	application/json

Payload

contacts	Array of strings List of contact phone numbers to assign
email	string <email> Email of the FreJun user to assign the contacts to
list_id	string ID of the contact list containing the contacts

Response

{
 "success": true,
 "message": "Successfully Assigned contacts"
}

Unassign Contacts

Unassign contacts from a user.

PATCH /integrations/unassign-contact/

Headers

Name	Value
Authorization	Bearer Access Token
Content-Type	application/json

Payload

contacts	Array of strings List of contact phone numbers to unassign
email	string <email> Email of the FreJun user to unassign the contacts from
list_id	string ID of the contact list containing the contacts

Response

{
 "success": true,
 "message": "Successfully Unassigned contacts"
}