📁 Contact Groups

Organize contacts into groups and categories

Create contact group

post

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/create/

Create a new contact group in the organisation. Group Name is required.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

unique_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Serializer for ContactGroup model supporting both creation and listing. Handles multilingual fields through parler TranslatableModelSerializer.

unique_idstring · max: 100 · nullableOptional

namestring · min: 1 · max: 200Required

descriptionstring · nullableOptional

translationsstringRequired

is_activebooleanOptional

date_createdstring · date-time · nullableOptional

last_updatedstring · date-time · nullableOptional

Responses

201Success

application/json

400

Bad Request - invalid or missing fields

401

Unauthorized

post

/api/v1.0/organisation/{unique_id}/contact-groups/create/

HTTPcURLJavaScriptPython

POST /api/v1.0/organisation/{unique_id}/contact-groups/create/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "translations": "text",
  "is_active": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "translations": "text",
  "is_active": true,
  "created_by_name": "text",
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

List contact groups

get

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/

Get all contact groups for an organisation

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

unique_idstringRequired

Responses

200Success

application/json

get

/api/v1.0/organisation/{unique_id}/contact-groups/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{unique_id}/contact-groups/ HTTP/1.1
Host: skhokho.ai
Accept: */*

200Success

[
  {
    "unique_id": "text",
    "name": "text",
    "description": "text",
    "translations": "text",
    "is_active": true,
    "created_by_name": "text",
    "date_created": "2026-02-04T19:17:44.163Z",
    "last_updated": "2026-02-04T19:17:44.163Z"
  }
]

Contact group details

get

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

Retrieve full information about a specific contact group.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

group_unique_idstringRequired

unique_idstringRequired

Responses

200Success

application/json

401

Unauthorized

404

Not Found

get

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/ HTTP/1.1
Host: skhokho.ai
Accept: */*

{
  "unique_id": "text",
  "translations": "text",
  "organisation_name": "text",
  "created_by_name": "text",
  "is_active": true,
  "contacts_count": 1,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

Update contact group (full)

put

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

Replace all editable fields of a contact group. Provide the full payload.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

group_unique_idstringRequired

unique_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Serializer for ContactGroup model supporting both creation and listing. Handles multilingual fields through parler TranslatableModelSerializer.

unique_idstring · max: 100 · nullableOptional

namestring · min: 1 · max: 200Required

descriptionstring · nullableOptional

translationsstringRequired

is_activebooleanOptional

date_createdstring · date-time · nullableOptional

last_updatedstring · date-time · nullableOptional

Responses

200Success

application/json

400

Bad Request - invalid or missing fields

401

Unauthorized

404

Not Found

put

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

HTTPcURLJavaScriptPython

PUT /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "translations": "text",
  "is_active": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "translations": "text",
  "is_active": true,
  "created_by_name": "text",
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

Delete contact group

delete

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

Delete a specific contact group from the organisation.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

group_unique_idstringRequired

unique_idstringRequired

Responses

200

Contact group deleted

No content

401

Unauthorized

404

Not Found

delete

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

HTTPcURLJavaScriptPython

DELETE /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/ HTTP/1.1
Host: skhokho.ai
Accept: */*

No content

Update contact group (partial)

patch

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

Partially update a contact group. Send only the fields that need changes.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

group_unique_idstringRequired

unique_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Serializer for ContactGroup model supporting both creation and listing. Handles multilingual fields through parler TranslatableModelSerializer.

unique_idstring · max: 100 · nullableOptional

namestring · min: 1 · max: 200Optional

descriptionstring · nullableOptional

translationsstringOptional

is_activebooleanOptional

date_createdstring · date-time · nullableOptional

last_updatedstring · date-time · nullableOptional

Responses

200Success

application/json

400

Bad Request - invalid fields

401

Unauthorized

404

Not Found

patch

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/

HTTPcURLJavaScriptPython

PATCH /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "translations": "text",
  "is_active": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "translations": "text",
  "is_active": true,
  "created_by_name": "text",
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

Create contact

post

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/create/

Create a new contact in a contact group. First name, last name, and entity type are required.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

group_unique_idstringRequired

unique_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Comprehensive serializer for Contact model. Handles contact creation, updates, and group assignment.

unique_idstring · max: 100 · nullableOptional

translationsstringRequired

contact_groupstring · nullableOptional

Contact group unique_id (optional - can be assigned later)

entity_typestring · enumRequired

Type of entity (client, vendor, lead)

• client - Client
• vendor - Vendor
• lead - Lead

Possible values:

entity_idstring · max: 100 · nullableOptional

ID of the entity this contact belongs to (optional for potential clients/vendors)

first_namestring · min: 1 · max: 150Required

last_namestring · min: 1 · max: 150Required

emailstring · email · max: 254 · nullableOptional

phonestring · max: 17 · nullableOptional

mobilestring · max: 17 · nullableOptional

linkedin_urlstring · uri · max: 200 · nullableOptional

LinkedIn profile URL

job_titlestring · nullableOptional

departmentstring · nullableOptional

notesstring · nullableOptional

is_activebooleanOptional

primary_contactbooleanOptional

Indicates if this is the primary contact for the entity

date_createdstring · date-time · nullableOptional

last_updatedstring · date-time · nullableOptional

Responses

201Success

application/json

400

Bad Request - Invalid input or missing required fields

401

Unauthorized

403

Forbidden

post

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/create/

HTTPcURLJavaScriptPython

POST /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/create/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 417

{
  "unique_id": "text",
  "translations": "text",
  "contact_group": "text",
  "entity_type": "client",
  "entity_id": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "mobile": "text",
  "linkedin_url": "https://example.com",
  "job_title": "text",
  "department": "text",
  "notes": "text",
  "is_active": true,
  "primary_contact": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "translations": "text",
  "organisation_name": "text",
  "created_by_name": "text",
  "contact_group": "text",
  "contact_group_id": "text",
  "contact_group_name": "text",
  "entity_type": "client",
  "entity_type_display": "text",
  "entity_id": "text",
  "first_name": "text",
  "last_name": "text",
  "full_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "mobile": "text",
  "linkedin_url": "https://example.com",
  "job_title": "text",
  "department": "text",
  "notes": "text",
  "is_active": true,
  "primary_contact": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

List contacts

get

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/

Get all contacts in a specific contact group with optional filters

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

group_unique_idstringRequired

unique_idstringRequired

Query parameters

entity_typestring · enumOptional

Filter by entity type

Possible values:

is_activestringOptional

Filter by active status (true/false)

searchstringOptional

Search contacts by first name, last name, email, or phone

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

get

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/ HTTP/1.1
Host: skhokho.ai
Accept: */*

[
  {
    "unique_id": "text",
    "translations": "text",
    "organisation_name": "text",
    "created_by_name": "text",
    "contact_group": "text",
    "contact_group_id": "text",
    "contact_group_name": "text",
    "entity_type": "client",
    "entity_type_display": "text",
    "entity_id": "text",
    "first_name": "text",
    "last_name": "text",
    "full_name": "text",
    "email": "[email protected]",
    "phone": "text",
    "mobile": "text",
    "linkedin_url": "https://example.com",
    "job_title": "text",
    "department": "text",
    "notes": "text",
    "is_active": true,
    "primary_contact": true,
    "date_created": "2026-02-04T19:17:44.163Z",
    "last_updated": "2026-02-04T19:17:44.163Z"
  }
]

Contact details

get

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/

Get a specific contact inside a group.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

contact_unique_idstringRequired

group_unique_idstringRequired

unique_idstringRequired

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/ HTTP/1.1
Host: skhokho.ai
Accept: */*

{
  "unique_id": "text",
  "translations": "text",
  "organisation_name": "text",
  "created_by_name": "text",
  "contact_group": "text",
  "contact_group_id": "text",
  "contact_group_name": "text",
  "entity_type": "client",
  "entity_type_display": "text",
  "entity_id": "text",
  "first_name": "text",
  "last_name": "text",
  "full_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "mobile": "text",
  "linkedin_url": "https://example.com",
  "job_title": "text",
  "department": "text",
  "notes": "text",
  "is_active": true,
  "primary_contact": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

Update contact

put

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/update/

Update a specific contact in a contact group (full or partial update)

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

contact_unique_idstringRequired

group_unique_idstringRequired

unique_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Comprehensive serializer for Contact model. Handles contact creation, updates, and group assignment.

unique_idstring · max: 100 · nullableOptional

translationsstringRequired

contact_groupstring · nullableOptional

Contact group unique_id (optional - can be assigned later)

entity_typestring · enumRequired

Type of entity (client, vendor, lead)

• client - Client
• vendor - Vendor
• lead - Lead

Possible values:

entity_idstring · max: 100 · nullableOptional

ID of the entity this contact belongs to (optional for potential clients/vendors)

first_namestring · min: 1 · max: 150Required

last_namestring · min: 1 · max: 150Required

emailstring · email · max: 254 · nullableOptional

phonestring · max: 17 · nullableOptional

mobilestring · max: 17 · nullableOptional

linkedin_urlstring · uri · max: 200 · nullableOptional

LinkedIn profile URL

job_titlestring · nullableOptional

departmentstring · nullableOptional

notesstring · nullableOptional

is_activebooleanOptional

primary_contactbooleanOptional

Indicates if this is the primary contact for the entity

date_createdstring · date-time · nullableOptional

last_updatedstring · date-time · nullableOptional

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

put

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/update/

HTTPcURLJavaScriptPython

PUT /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 417

{
  "unique_id": "text",
  "translations": "text",
  "contact_group": "text",
  "entity_type": "client",
  "entity_id": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "mobile": "text",
  "linkedin_url": "https://example.com",
  "job_title": "text",
  "department": "text",
  "notes": "text",
  "is_active": true,
  "primary_contact": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "translations": "text",
  "organisation_name": "text",
  "created_by_name": "text",
  "contact_group": "text",
  "contact_group_id": "text",
  "contact_group_name": "text",
  "entity_type": "client",
  "entity_type_display": "text",
  "entity_id": "text",
  "first_name": "text",
  "last_name": "text",
  "full_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "mobile": "text",
  "linkedin_url": "https://example.com",
  "job_title": "text",
  "department": "text",
  "notes": "text",
  "is_active": true,
  "primary_contact": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

Update contact

patch

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/update/

Update a specific contact in a contact group (full or partial update)

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

contact_unique_idstringRequired

group_unique_idstringRequired

unique_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Comprehensive serializer for Contact model. Handles contact creation, updates, and group assignment.

unique_idstring · max: 100 · nullableOptional

translationsstringOptional

contact_groupstring · nullableOptional

Contact group unique_id (optional - can be assigned later)

entity_typestring · enumOptional

Type of entity (client, vendor, lead)

• client - Client
• vendor - Vendor
• lead - Lead

Possible values:

entity_idstring · max: 100 · nullableOptional

ID of the entity this contact belongs to (optional for potential clients/vendors)

first_namestring · min: 1 · max: 150Optional

last_namestring · min: 1 · max: 150Optional

emailstring · email · max: 254 · nullableOptional

phonestring · max: 17 · nullableOptional

mobilestring · max: 17 · nullableOptional

linkedin_urlstring · uri · max: 200 · nullableOptional

LinkedIn profile URL

job_titlestring · nullableOptional

departmentstring · nullableOptional

notesstring · nullableOptional

is_activebooleanOptional

primary_contactbooleanOptional

Indicates if this is the primary contact for the entity

date_createdstring · date-time · nullableOptional

last_updatedstring · date-time · nullableOptional

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

patch

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/update/

HTTPcURLJavaScriptPython

PATCH /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 417

{
  "unique_id": "text",
  "translations": "text",
  "contact_group": "text",
  "entity_type": "client",
  "entity_id": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "mobile": "text",
  "linkedin_url": "https://example.com",
  "job_title": "text",
  "department": "text",
  "notes": "text",
  "is_active": true,
  "primary_contact": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "translations": "text",
  "organisation_name": "text",
  "created_by_name": "text",
  "contact_group": "text",
  "contact_group_id": "text",
  "contact_group_name": "text",
  "entity_type": "client",
  "entity_type_display": "text",
  "entity_id": "text",
  "first_name": "text",
  "last_name": "text",
  "full_name": "text",
  "email": "[email protected]",
  "phone": "text",
  "mobile": "text",
  "linkedin_url": "https://example.com",
  "job_title": "text",
  "department": "text",
  "notes": "text",
  "is_active": true,
  "primary_contact": true,
  "date_created": "2026-02-04T19:17:44.163Z",
  "last_updated": "2026-02-04T19:17:44.163Z"
}

Delete contact

delete

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/delete/

Delete a specific contact from a contact group

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

contact_unique_idstringRequired

group_unique_idstringRequired

unique_idstringRequired

Responses

204

No Content

401

Unauthorized

403

Forbidden

404

Not Found

delete

/api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/delete/

HTTPcURLJavaScriptPython

DELETE /api/v1.0/organisation/{unique_id}/contact-groups/{group_unique_id}/contacts/{contact_unique_id}/delete/ HTTP/1.1
Host: skhokho.ai
Accept: */*

No content