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

# mailtrap-contacts

> Mailtrap Contacts - contact management, lists, fields, events, bulk import, and export

**Server path:** `/mailtrap-contacts` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                  | Description            |
| ------------------------------------------------------------------------------------- | ---------------------- |
| [`mailtrap_contacts_contact_fields`](#mailtrap_contacts_contact_fields)               | Get all Contact Fields |
| [`mailtrap_contacts_contact_lists`](#mailtrap_contacts_contact_lists)                 | Get all Contact Lists  |
| [`mailtrap_contacts_create_contact`](#mailtrap_contacts_create_contact)               | Create a new Contact   |
| [`mailtrap_contacts_create_contact_event`](#mailtrap_contacts_create_contact_event)   | Create contact event   |
| [`mailtrap_contacts_create_contact_export`](#mailtrap_contacts_create_contact_export) | Create Contact Export  |
| [`mailtrap_contacts_create_contact_field`](#mailtrap_contacts_create_contact_field)   | Create Contact Field   |
| [`mailtrap_contacts_create_contact_list`](#mailtrap_contacts_create_contact_list)     | Create Contact List    |
| [`mailtrap_contacts_delete_contact`](#mailtrap_contacts_delete_contact)               | Delete contact         |
| [`mailtrap_contacts_delete_contact_field`](#mailtrap_contacts_delete_contact_field)   | Delete Contact Field   |
| [`mailtrap_contacts_delete_contact_list`](#mailtrap_contacts_delete_contact_list)     | Delete Contact List    |
| [`mailtrap_contacts_get_contact`](#mailtrap_contacts_get_contact)                     | Get contact            |
| [`mailtrap_contacts_get_contact_export`](#mailtrap_contacts_get_contact_export)       | Get Contact Export     |
| [`mailtrap_contacts_get_contact_field`](#mailtrap_contacts_get_contact_field)         | Get Contact Field      |
| [`mailtrap_contacts_get_contact_import`](#mailtrap_contacts_get_contact_import)       | Get Contact Import     |
| [`mailtrap_contacts_get_contact_list`](#mailtrap_contacts_get_contact_list)           | Get Contact List       |
| [`mailtrap_contacts_import_contacts`](#mailtrap_contacts_import_contacts)             | Import contacts        |
| [`mailtrap_contacts_update_contact`](#mailtrap_contacts_update_contact)               | Update contact         |
| [`mailtrap_contacts_update_contact_field`](#mailtrap_contacts_update_contact_field)   | Update Contact Field   |
| [`mailtrap_contacts_update_contact_list`](#mailtrap_contacts_update_contact_list)     | Update Contact List    |

***

## mailtrap\_contacts\_contact\_fields

Get all Contact Fields

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `account_id` | integer | Yes      | —       | Unique account ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      }
    },
    "required": [
      "PCID",
      "account_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_contact\_lists

Get all Contact Lists

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `account_id` | integer | Yes      | —       | Unique account ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      }
    },
    "required": [
      "PCID",
      "account_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_create\_contact

Create a new Contact

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `account_id` | integer | Yes      | —       | Unique account ID |
| `contact`    | object  | Yes      | —       | The contact value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "contact": {
        "type": "object",
        "description": "The contact value",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email value"
          },
          "fields": {
            "type": "object",
            "description": "The fields value"
          },
          "list_ids": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "List Ids"
          }
        },
        "required": [
          "email"
        ]
      }
    },
    "required": [
      "PCID",
      "account_id",
      "contact"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_create\_contact\_event

Create contact event

**Parameters:**

| Parameter            | Type    | Required | Default | Description                                  |
| -------------------- | ------- | -------- | ------- | -------------------------------------------- |
| `account_id`         | integer | Yes      | —       | Unique account ID                            |
| `contact_identifier` | string  | Yes      | —       | Contact UUID or Email                        |
| `name`               | string  | No       | —       | The name value                               |
| `params`             | object  | No       | —       | A hash of string keys and scalar JSON values |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "contact_identifier": {
        "type": "string",
        "description": "Contact UUID or Email"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "params": {
        "type": "object",
        "description": "A hash of string keys and scalar JSON values"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "contact_identifier"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_create\_contact\_export

Create Contact Export

**Parameters:**

| Parameter    | Type    | Required | Default | Description                             |
| ------------ | ------- | -------- | ------- | --------------------------------------- |
| `account_id` | integer | Yes      | —       | Unique account ID                       |
| `filters`    | any\[]  | No       | —       | Array of filters to apply to the search |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "filters": {
        "type": "array",
        "description": "Array of filters to apply to the search"
      }
    },
    "required": [
      "PCID",
      "account_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_create\_contact\_field

Create Contact Field

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                                   |
| ------------ | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `account_id` | integer | Yes      | —       | Unique account ID                                                                                                             |
| `data_type`  | string  | No       | —       | Data Type                                                                                                                     |
| `merge_tag`  | string  | No       | —       | Personalize your campaigns by adding a merge tag. This field will be replaced with unique contact details for each recipient. |
| `name`       | string  | No       | —       | The name value                                                                                                                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "data_type": {
        "type": "string",
        "description": "Data Type",
        "enum": [
          "text",
          "integer",
          "float",
          "boolean",
          "date"
        ]
      },
      "merge_tag": {
        "type": "string",
        "description": "Personalize your campaigns by adding a merge tag. This field will be replaced with unique contact details for each recipient."
      },
      "name": {
        "type": "string",
        "description": "The name value"
      }
    },
    "required": [
      "PCID",
      "account_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_create\_contact\_list

Create Contact List

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `account_id` | integer | Yes      | —       | Unique account ID |
| `name`       | string  | No       | —       | The name value    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      }
    },
    "required": [
      "PCID",
      "account_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_delete\_contact

Delete contact

**Parameters:**

| Parameter            | Type    | Required | Default | Description           |
| -------------------- | ------- | -------- | ------- | --------------------- |
| `account_id`         | integer | Yes      | —       | Unique account ID     |
| `contact_identifier` | string  | Yes      | —       | Contact UUID or Email |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "contact_identifier": {
        "type": "string",
        "description": "Contact UUID or Email"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "contact_identifier"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_delete\_contact\_field

Delete Contact Field

**Parameters:**

| Parameter    | Type    | Required | Default | Description             |
| ------------ | ------- | -------- | ------- | ----------------------- |
| `account_id` | integer | Yes      | —       | Unique account ID       |
| `field_id`   | integer | Yes      | —       | Unique Contact Field ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "field_id": {
        "type": "integer",
        "description": "Unique Contact Field ID"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "field_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_delete\_contact\_list

Delete Contact List

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `account_id` | integer | Yes      | —       | Unique account ID |
| `list_id`    | integer | Yes      | —       | Unique list ID    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "list_id": {
        "type": "integer",
        "description": "Unique list ID"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "list_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_get\_contact

Get contact

**Parameters:**

| Parameter            | Type    | Required | Default | Description           |
| -------------------- | ------- | -------- | ------- | --------------------- |
| `account_id`         | integer | Yes      | —       | Unique account ID     |
| `contact_identifier` | string  | Yes      | —       | Contact UUID or Email |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "contact_identifier": {
        "type": "string",
        "description": "Contact UUID or Email"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "contact_identifier"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_get\_contact\_export

Get Contact Export

**Parameters:**

| Parameter    | Type    | Required | Default | Description              |
| ------------ | ------- | -------- | ------- | ------------------------ |
| `account_id` | integer | Yes      | —       | Unique account ID        |
| `export_id`  | integer | Yes      | —       | Unique Contact Export ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "export_id": {
        "type": "integer",
        "description": "Unique Contact Export ID"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "export_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_get\_contact\_field

Get Contact Field

**Parameters:**

| Parameter    | Type    | Required | Default | Description             |
| ------------ | ------- | -------- | ------- | ----------------------- |
| `account_id` | integer | Yes      | —       | Unique account ID       |
| `field_id`   | integer | Yes      | —       | Unique Contact Field ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "field_id": {
        "type": "integer",
        "description": "Unique Contact Field ID"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "field_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_get\_contact\_import

Get Contact Import

**Parameters:**

| Parameter    | Type    | Required | Default | Description              |
| ------------ | ------- | -------- | ------- | ------------------------ |
| `account_id` | integer | Yes      | —       | Unique account ID        |
| `import_id`  | integer | Yes      | —       | Unique Contact Import ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "import_id": {
        "type": "integer",
        "description": "Unique Contact Import ID"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "import_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_get\_contact\_list

Get Contact List

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `account_id` | integer | Yes      | —       | Unique account ID |
| `list_id`    | integer | Yes      | —       | Unique list ID    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "list_id": {
        "type": "integer",
        "description": "Unique list ID"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "list_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_import\_contacts

Import contacts

**Parameters:**

| Parameter    | Type      | Required | Default | Description        |
| ------------ | --------- | -------- | ------- | ------------------ |
| `account_id` | integer   | Yes      | —       | Unique account ID  |
| `contacts`   | object\[] | No       | —       | The contacts value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "contacts": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "description": "The email value"
            },
            "fields": {
              "type": "object",
              "description": "Object of fields in the following format:   field_merge_tag: string | integer | float | boolean | date string in ISO-8601 format (yyyy-mm-dd);"
            },
            "list_ids_included": {
              "type": "array",
              "items": {
                "type": "integer"
              },
              "description": "List Ids Included"
            },
            "list_ids_excluded": {
              "type": "array",
              "items": {
                "type": "integer"
              },
              "description": "List Ids Excluded"
            }
          }
        },
        "description": "The contacts value"
      }
    },
    "required": [
      "PCID",
      "account_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_update\_contact

Update contact

**Parameters:**

| Parameter            | Type    | Required | Default | Description           |
| -------------------- | ------- | -------- | ------- | --------------------- |
| `account_id`         | integer | Yes      | —       | Unique account ID     |
| `contact_identifier` | string  | Yes      | —       | Contact UUID or Email |
| `contact`            | object  | Yes      | —       | The contact value     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "contact_identifier": {
        "type": "string",
        "description": "Contact UUID or Email"
      },
      "contact": {
        "type": "object",
        "description": "The contact value",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email value"
          },
          "fields": {
            "type": "object",
            "description": "The fields value"
          },
          "list_ids_included": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "List Ids Included"
          },
          "list_ids_excluded": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "List Ids Excluded"
          },
          "unsubscribed": {
            "type": "boolean",
            "description": "The unsubscribed value"
          }
        },
        "required": [
          "email"
        ]
      }
    },
    "required": [
      "PCID",
      "account_id",
      "contact_identifier",
      "contact"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_update\_contact\_field

Update Contact Field

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                                   |
| ------------ | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `account_id` | integer | Yes      | —       | Unique account ID                                                                                                             |
| `field_id`   | integer | Yes      | —       | Unique Contact Field ID                                                                                                       |
| `merge_tag`  | string  | No       | —       | Personalize your campaigns by adding a merge tag. This field will be replaced with unique contact details for each recipient. |
| `name`       | string  | No       | —       | The name value                                                                                                                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "field_id": {
        "type": "integer",
        "description": "Unique Contact Field ID"
      },
      "merge_tag": {
        "type": "string",
        "description": "Personalize your campaigns by adding a merge tag. This field will be replaced with unique contact details for each recipient."
      },
      "name": {
        "type": "string",
        "description": "The name value"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "field_id"
    ]
  }
  ```
</Expandable>

***

## mailtrap\_contacts\_update\_contact\_list

Update Contact List

**Parameters:**

| Parameter    | Type    | Required | Default | Description       |
| ------------ | ------- | -------- | ------- | ----------------- |
| `account_id` | integer | Yes      | —       | Unique account ID |
| `list_id`    | integer | Yes      | —       | Unique list ID    |
| `name`       | string  | No       | —       | The name value    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "account_id": {
        "type": "integer",
        "description": "Unique account ID"
      },
      "list_id": {
        "type": "integer",
        "description": "Unique list ID"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      }
    },
    "required": [
      "PCID",
      "account_id",
      "list_id"
    ]
  }
  ```
</Expandable>