# Contact Endpoints {#contact-endpoints}


Manage organization contacts — customers, vendors, leads, and other business contacts used across the CRM module.


## Base Path {#base-path}


```
/api/organization-contact
```


## Endpoints {#endpoints}



### List Contacts (Paginated) {#list-contacts-paginated}


```
GET /api/organization-contact/pagination
Authorization: Bearer {token}
```


### Find All Contacts {#find-all-contacts}


```
GET /api/organization-contact
Authorization: Bearer {token}
```


### Get Contact by ID {#get-contact-by-id}


```
GET /api/organization-contact/:id
Authorization: Bearer {token}
```


### Create Contact {#create-contact}


```
POST /api/organization-contact
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "Acme Corporation",
  "contactType": "CUSTOMER",
  "primaryEmail": "info@acme.com",
  "primaryPhone": "+1-555-0123",
  "organizationId": "uuid",
  "imageUrl": "https://...",
  "budget": 50000,
  "budgetType": "HOURS",
  "members": [{ "id": "employee-uuid" }],
  "tags": [{ "id": "tag-uuid" }]
}
```


### Update Contact {#update-contact}


```
PUT /api/organization-contact/:id
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "Updated Contact Name",
  "primaryEmail": "new@email.com"
}
```


### Delete Contact {#delete-contact}


```
DELETE /api/organization-contact/:id
Authorization: Bearer {token}
```


## Contact Types {#contact-types}


| Type       | Description          |
| ---------- | -------------------- |
| `CUSTOMER` | Paying customer      |
| `CLIENT`   | Client relationship  |
| `LEAD`     | Prospective customer |
| `VENDOR`   | Supplier or vendor   |
| `PARTNER`  | Business partner     |


## Data Model {#data-model}


```typescript
interface IOrganizationContact {
  id: string;
  name: string;
  contactType: ContactType;
  primaryEmail?: string;
  primaryPhone?: string;
  imageUrl?: string;
  budget?: number;
  budgetType?: OrganizationContactBudgetTypeEnum;
  notes?: string;

  // Relations
  organizationId: string;
  members?: IEmployee[];
  projects?: IOrganizationProject[];
  invoices?: IInvoice[];
  tags?: ITag[];
  tenantId: string;
}
```


## Permissions {#permissions}


| Action          | Required Permission                  |
| --------------- | ------------------------------------ |
| View contacts   | `ALL_ORG_VIEW` or `ORG_CONTACT_VIEW` |
| Create contacts | `ALL_ORG_EDIT` or `ORG_CONTACT_EDIT` |
| Update contacts | `ALL_ORG_EDIT` or `ORG_CONTACT_EDIT` |
| Delete contacts | `ALL_ORG_EDIT` or `ORG_CONTACT_EDIT` |


## Related Pages {#related-pages}


- [CRM Overview](https://sourcey-gauzy.pages.dev/features/crm-overview/index.md) — CRM feature documentation
- [Pipeline & Deal Endpoints](https://sourcey-gauzy.pages.dev/api/pipeline-deal-endpoints/index.md) — sales pipelines
- [Contacts Management](https://sourcey-gauzy.pages.dev/features/contacts-management/index.md) — feature guide