> ## Documentation Index
> Fetch the complete documentation index at: https://developer.swoogo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contacts

> Query and create account-level CRM contacts

## swoogo\_get\_contacts

List or retrieve contacts from your Swoogo CRM. Contacts are account-level records, not tied to a specific event.

### Parameters

| Parameter    | Type    | Required | Description                              |
| ------------ | ------- | -------- | ---------------------------------------- |
| `contact_id` | integer | No       | Get a single contact by ID               |
| `email`      | string  | No       | Filter by email address                  |
| `name`       | string  | No       | Filter by name (partial match)           |
| `company`    | string  | No       | Filter by company name                   |
| `search`     | string  | No       | Raw Swoogo search filter                 |
| `fields`     | string  | No       | Comma-separated fields to return         |
| `expand`     | string  | No       | Include related objects                  |
| `page`       | integer | No       | Page number (default: 1)                 |
| `per_page`   | integer | No       | Results per page (default: 20, max: 100) |
| `sort`       | string  | No       | Sort field (prefix `-` for descending)   |

### Example prompts

* *"Find the contact with email [jane@example.com](mailto:jane@example.com)"*
* *"List contacts from Acme Corp"*

***

## swoogo\_create\_contact

Create a new contact in your Swoogo CRM.

### Parameters

| Parameter           | Type   | Required | Description           |
| ------------------- | ------ | -------- | --------------------- |
| `email`             | string | Yes      | Contact email address |
| `first_name`        | string | No       | First name            |
| `last_name`         | string | No       | Last name             |
| `company`           | string | No       | Company name          |
| `job_title`         | string | No       | Job title             |
| `additional_fields` | object | No       | Custom field values   |