gist-contacts - Pinkfish - AI Agents & Workflows for Getting Work Done

Server path: /gist-contacts | Type: Application | PCID required: Yes

Tools

Tool	Description
`gist_contacts_batch_create_contacts`	Batch create or update contacts
`gist_contacts_create_or_update_contact`	Create or update a contact
`gist_contacts_create_or_update_tag`	Create, update, or manage tag-contact associations
`gist_contacts_delete_contact`	Delete a contact
`gist_contacts_delete_tag`	Delete a tag
`gist_contacts_get_batch_status`	Get batch import status
`gist_contacts_get_campaign`	Retrieve a campaign
`gist_contacts_get_contact`	Retrieve a contact by ID
`gist_contacts_get_segment`	Retrieve a segment
`gist_contacts_get_subscription_type`	Retrieve a subscription type
`gist_contacts_list_campaigns`	List all campaigns
`gist_contacts_list_contacts`	List all contacts
`gist_contacts_list_events`	List all events
`gist_contacts_list_form_submissions`	List form submissions
`gist_contacts_list_forms`	List all forms
`gist_contacts_list_segments`	List all segments
`gist_contacts_list_subscription_types`	List all subscription types
`gist_contacts_list_tags`	List all tags
`gist_contacts_manage_campaign_subscription`	Subscribe or unsubscribe a contact from a campaign
`gist_contacts_manage_subscription_type_contact`	Attach or detach a contact from a subscription type
`gist_contacts_subscribe_contact_to_form`	Subscribe a contact to a form
`gist_contacts_track_event`	Track a custom event

gist_contacts_batch_create_contacts

Batch create or update contacts Parameters:

Parameter	Type	Required	Default	Description
`contacts`	object[]	Yes	—	Array of contact objects to create or update

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "contacts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email value"
          },
          "user_id": {
            "type": "string",
            "description": "User Id"
          },
          "name": {
            "type": "string",
            "description": "The name value"
          },
          "phone": {
            "type": "string",
            "description": "The phone value"
          },
          "custom_properties": {
            "type": "object",
            "description": "Custom Properties"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The tags value"
          }
        }
      },
      "description": "Array of contact objects to create or update"
    }
  },
  "required": [
    "PCID",
    "contacts"
  ]
}

gist_contacts_create_or_update_contact

Create or update a contact Parameters:

Parameter	Type	Required	Default	Description
`custom_properties`	object	No	—	Custom properties as key-value pairs
`email`	string	No	—	Contact email address
`last_seen_ip`	string	No	—	Last seen IP address
`last_seen_user_agent`	string	No	—	Last seen user agent
`name`	string	No	—	Contact name
`phone`	string	No	—	Phone number
`signed_up_at`	integer	No	—	Sign-up timestamp (Unix)
`tags`	string[]	No	—	Tag names to add to the contact
`unsubscribed_from_emails`	boolean	No	—	Whether contact is unsubscribed from emails
`user_id`	string	No	—	External user ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "custom_properties": {
      "type": "object",
      "description": "Custom properties as key-value pairs"
    },
    "email": {
      "type": "string",
      "description": "Contact email address"
    },
    "last_seen_ip": {
      "type": "string",
      "description": "Last seen IP address"
    },
    "last_seen_user_agent": {
      "type": "string",
      "description": "Last seen user agent"
    },
    "name": {
      "type": "string",
      "description": "Contact name"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "signed_up_at": {
      "type": "integer",
      "description": "Sign-up timestamp (Unix)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag names to add to the contact"
    },
    "unsubscribed_from_emails": {
      "type": "boolean",
      "description": "Whether contact is unsubscribed from emails"
    },
    "user_id": {
      "type": "string",
      "description": "External user ID"
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_create_or_update_tag

Create, update, or manage tag-contact associations Parameters:

Parameter	Type	Required	Default	Description
`contacts`	object[]	No	—	Contacts to tag or untag
`id`	string	No	—	Tag ID (required for update or tag/untag operations)
`name`	string	Yes	—	Tag name

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "contacts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The id value"
          },
          "email": {
            "type": "string",
            "description": "The email value"
          },
          "user_id": {
            "type": "string",
            "description": "User Id"
          },
          "untag": {
            "type": "boolean",
            "description": "Set to true to remove this tag from the contact"
          }
        }
      },
      "description": "Contacts to tag or untag"
    },
    "id": {
      "type": "string",
      "description": "Tag ID (required for update or tag/untag operations)"
    },
    "name": {
      "type": "string",
      "description": "Tag name"
    }
  },
  "required": [
    "PCID",
    "name"
  ]
}

gist_contacts_delete_contact

Delete a contact Parameters:

Parameter	Type	Required	Default	Description
`id`	string	Yes	—	Contact ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "Contact ID"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

gist_contacts_delete_tag

Delete a tag Parameters:

Parameter	Type	Required	Default	Description
`id`	string	Yes	—	Tag ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "Tag ID"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

gist_contacts_get_batch_status

Get batch import status Parameters:

Parameter	Type	Required	Default	Description
`batch_id`	string	Yes	—	Batch import ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "batch_id": {
      "type": "string",
      "description": "Batch import ID"
    }
  },
  "required": [
    "PCID",
    "batch_id"
  ]
}

gist_contacts_get_campaign

Retrieve a campaign Parameters:

Parameter	Type	Required	Default	Description
`id`	string	Yes	—	Campaign ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "Campaign ID"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

gist_contacts_get_contact

Retrieve a contact by ID Parameters:

Parameter	Type	Required	Default	Description
`id`	string	Yes	—	Contact ID
`user_id`	string	No	—	Alternative: look up by user_id
`email`	string	No	—	Alternative: look up by email

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "Contact ID"
    },
    "user_id": {
      "type": "string",
      "description": "Alternative: look up by user_id"
    },
    "email": {
      "type": "string",
      "description": "Alternative: look up by email"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

gist_contacts_get_segment

Retrieve a segment Parameters:

Parameter	Type	Required	Default	Description
`id`	string	Yes	—	Segment ID
`include_count`	boolean	No	—	Include contact count

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "Segment ID"
    },
    "include_count": {
      "type": "boolean",
      "description": "Include contact count"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

gist_contacts_get_subscription_type

Retrieve a subscription type Parameters:

Parameter	Type	Required	Default	Description
`subscription_type_id`	integer	Yes	—	Subscription type ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "subscription_type_id": {
      "type": "integer",
      "description": "Subscription type ID"
    }
  },
  "required": [
    "PCID",
    "subscription_type_id"
  ]
}

gist_contacts_list_campaigns

List all campaigns Parameters:

Parameter	Type	Required	Default	Description
`status`	string	No	—	Filter by status
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "status": {
      "type": "string",
      "description": "Filter by status",
      "enum": [
        "draft",
        "active",
        "paused"
      ]
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page"
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_list_contacts

List all contacts Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page (max 60)
`order`	string	No	—	Sort order
`order_by`	string	No	—	Sort field
`created_since`	integer	No	—	Filter contacts created in the last N days
`status`	string	No	—	Filter by status
`form_id`	string	No	—	Filter by form ID
`email_like`	string	No	—	Filter by email pattern
`segment_id`	string	No	—	Filter by segment ID
`campaign_id`	string	No	—	Filter by campaign ID
`tag_id`	string	No	—	Filter by tag ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page (max 60)"
    },
    "order": {
      "type": "string",
      "description": "Sort order",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "order_by": {
      "type": "string",
      "description": "Sort field",
      "enum": [
        "created_at",
        "updated_at",
        "last_seen_at",
        "signed_up_at"
      ]
    },
    "created_since": {
      "type": "integer",
      "description": "Filter contacts created in the last N days"
    },
    "status": {
      "type": "string",
      "description": "Filter by status",
      "enum": [
        "active",
        "unsubscribed",
        "bounced"
      ]
    },
    "form_id": {
      "type": "string",
      "description": "Filter by form ID"
    },
    "email_like": {
      "type": "string",
      "description": "Filter by email pattern"
    },
    "segment_id": {
      "type": "string",
      "description": "Filter by segment ID"
    },
    "campaign_id": {
      "type": "string",
      "description": "Filter by campaign ID"
    },
    "tag_id": {
      "type": "string",
      "description": "Filter by tag ID"
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_list_events

List all events Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page (max 60)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page (max 60)"
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_list_form_submissions

List form submissions Parameters:

Parameter	Type	Required	Default	Description
`form_id`	string	Yes	—	Form ID
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page (max 60)
`order`	string	No	—	Sort order
`order_by`	string	No	—	Sort field

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "form_id": {
      "type": "string",
      "description": "Form ID"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page (max 60)"
    },
    "order": {
      "type": "string",
      "description": "Sort order",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "order_by": {
      "type": "string",
      "description": "Sort field"
    }
  },
  "required": [
    "PCID",
    "form_id"
  ]
}

gist_contacts_list_forms

List all forms Parameters:

Parameter	Type	Required	Default	Description
`form_id`	string	No	—	Specific form ID to retrieve
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page (max 60)
`order`	string	No	—	Sort order
`order_by`	string	No	—	Sort field
`status`	string	No	—	Filter by form status

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "form_id": {
      "type": "string",
      "description": "Specific form ID to retrieve"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page (max 60)"
    },
    "order": {
      "type": "string",
      "description": "Sort order",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "order_by": {
      "type": "string",
      "description": "Sort field"
    },
    "status": {
      "type": "string",
      "description": "Filter by form status",
      "enum": [
        "live",
        "paused",
        "draft"
      ]
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_list_segments

List all segments Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page
`order`	string	No	—	Sort order
`order_by`	string	No	—	Sort field
`include_count`	boolean	No	—	Include contact count per segment

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page"
    },
    "order": {
      "type": "string",
      "description": "Sort order",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "order_by": {
      "type": "string",
      "description": "Sort field"
    },
    "include_count": {
      "type": "boolean",
      "description": "Include contact count per segment"
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_list_subscription_types

List all subscription types Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page"
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_list_tags

List all tags Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Results per page
`order`	string	No	—	Sort order
`order_by`	string	No	—	Sort field

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page"
    },
    "order": {
      "type": "string",
      "description": "Sort order",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "order_by": {
      "type": "string",
      "description": "Sort field"
    }
  },
  "required": [
    "PCID"
  ]
}

gist_contacts_manage_campaign_subscription

Subscribe or unsubscribe a contact from a campaign Parameters:

Parameter	Type	Required	Default	Description
`email`	string	No	—	Contact email
`id`	string	Yes	—	Campaign ID
`reactivate_if_removed`	boolean	No	—	Reactivate if previously removed
`starting_email_index`	integer	No	—	Starting email index (default 0)
`unsubscribed`	boolean	No	—	Set to true to unsubscribe the contact
`user_id`	string	No	—	Contact user ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "email": {
      "type": "string",
      "description": "Contact email"
    },
    "id": {
      "type": "string",
      "description": "Campaign ID"
    },
    "reactivate_if_removed": {
      "type": "boolean",
      "description": "Reactivate if previously removed"
    },
    "starting_email_index": {
      "type": "integer",
      "description": "Starting email index (default 0)"
    },
    "unsubscribed": {
      "type": "boolean",
      "description": "Set to true to unsubscribe the contact"
    },
    "user_id": {
      "type": "string",
      "description": "Contact user ID"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

gist_contacts_manage_subscription_type_contact

Attach or detach a contact from a subscription type Parameters:

Parameter	Type	Required	Default	Description
`subscription_type_id`	integer	Yes	—	Subscription type ID
`contact_id`	string	No	—	Contact ID
`email`	string	No	—	Contact email
`subscribed_status`	boolean	Yes	—	True to attach, false to detach
`user_id`	string	No	—	Contact user ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "subscription_type_id": {
      "type": "integer",
      "description": "Subscription type ID"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID"
    },
    "email": {
      "type": "string",
      "description": "Contact email"
    },
    "subscribed_status": {
      "type": "boolean",
      "description": "True to attach, false to detach"
    },
    "user_id": {
      "type": "string",
      "description": "Contact user ID"
    }
  },
  "required": [
    "PCID",
    "subscription_type_id",
    "subscribed_status"
  ]
}

gist_contacts_subscribe_contact_to_form

Subscribe a contact to a form Parameters:

Parameter	Type	Required	Default	Description
`form_id`	string	Yes	—	Form ID
`consent_to_process`	boolean	No	—	Consent to process data
`consent_to_process_text`	string	No	—	Consent text
`fields`	object	Yes	—	Form field name/value pairs
`ip_address`	string	No	—	Submitter’s IP address
`page_title`	string	No	—	Page title where form was submitted
`page_url`	string	No	—	Page URL where form was submitted
`skip_validation`	boolean	No	—	Skip form field validation
`submitted_at`	integer	No	—	Submission timestamp (Unix ms)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "form_id": {
      "type": "string",
      "description": "Form ID"
    },
    "consent_to_process": {
      "type": "boolean",
      "description": "Consent to process data"
    },
    "consent_to_process_text": {
      "type": "string",
      "description": "Consent text"
    },
    "fields": {
      "type": "object",
      "description": "Form field name/value pairs"
    },
    "ip_address": {
      "type": "string",
      "description": "Submitter's IP address"
    },
    "page_title": {
      "type": "string",
      "description": "Page title where form was submitted"
    },
    "page_url": {
      "type": "string",
      "description": "Page URL where form was submitted"
    },
    "skip_validation": {
      "type": "boolean",
      "description": "Skip form field validation"
    },
    "submitted_at": {
      "type": "integer",
      "description": "Submission timestamp (Unix ms)"
    }
  },
  "required": [
    "PCID",
    "form_id",
    "fields"
  ]
}

gist_contacts_track_event

Track a custom event Parameters:

Parameter	Type	Required	Default	Description
`email`	string	No	—	Contact email (required if no user_id or id)
`event_name`	string	Yes	—	Event name
`id`	string	No	—	Contact ID (required if no email or user_id)
`occurred_at`	integer	No	—	Unix timestamp when the event occurred (defaults to now)
`properties`	object	No	—	Event properties as key-value pairs
`user_id`	string	No	—	User ID (required if no email or id)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "email": {
      "type": "string",
      "description": "Contact email (required if no user_id or id)"
    },
    "event_name": {
      "type": "string",
      "description": "Event name"
    },
    "id": {
      "type": "string",
      "description": "Contact ID (required if no email or user_id)"
    },
    "occurred_at": {
      "type": "integer",
      "description": "Unix timestamp when the event occurred (defaults to now)"
    },
    "properties": {
      "type": "object",
      "description": "Event properties as key-value pairs"
    },
    "user_id": {
      "type": "string",
      "description": "User ID (required if no email or id)"
    }
  },
  "required": [
    "PCID",
    "event_name"
  ]
}

​Tools

​gist_contacts_batch_create_contacts

​gist_contacts_create_or_update_contact

​gist_contacts_create_or_update_tag

​gist_contacts_delete_contact

​gist_contacts_delete_tag

​gist_contacts_get_batch_status

​gist_contacts_get_campaign

​gist_contacts_get_contact

​gist_contacts_get_segment

​gist_contacts_get_subscription_type

​gist_contacts_list_campaigns

​gist_contacts_list_contacts

​gist_contacts_list_events

​gist_contacts_list_form_submissions

​gist_contacts_list_forms

​gist_contacts_list_segments

​gist_contacts_list_subscription_types

​gist_contacts_list_tags

​gist_contacts_manage_campaign_subscription

​gist_contacts_manage_subscription_type_contact

​gist_contacts_subscribe_contact_to_form

​gist_contacts_track_event

Tools

gist_contacts_batch_create_contacts

gist_contacts_create_or_update_contact

gist_contacts_create_or_update_tag

gist_contacts_delete_contact

gist_contacts_delete_tag

gist_contacts_get_batch_status

gist_contacts_get_campaign

gist_contacts_get_contact

gist_contacts_get_segment

gist_contacts_get_subscription_type

gist_contacts_list_campaigns

gist_contacts_list_contacts

gist_contacts_list_events

gist_contacts_list_form_submissions

gist_contacts_list_forms

gist_contacts_list_segments

gist_contacts_list_subscription_types

gist_contacts_list_tags

gist_contacts_manage_campaign_subscription

gist_contacts_manage_subscription_type_contact

gist_contacts_subscribe_contact_to_form

gist_contacts_track_event