Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cometly.com/llms.txt

Use this file to discover all available pages before exploring further.

​
v1.0.7

​
May 14, 2026

  • Update Contact endpoint — Added PUT /contacts/ for updating an existing contact’s emails, phones, names, locations, and custom_fields. Uses sparse PUT semantics: any field you include replaces the existing collection in full; any field you omit is left untouched. Empty arrays ([]) wipe a collection; providing custom_fields clears every key not in the object.
  • Update Company endpoint — Added PUT /companies/ for updating a company’s domain and name. Uses sparse PUT semantics — only the fields you include are modified.
  • name field on Get Company — The Get Company response now includes name alongside id and domain. This is an additive change; existing fields are unchanged.

​
v1.0.6

​
April 20, 2026

  • include_browsing_session_data parameter on Get Contact — Added include_browsing_session_data to the Get Contact endpoint. When set to 1, the response includes a browsing_session_hits array with up to the last 1000 raw browsing hits (page views) for the contact, ordered by most recent first. Each hit includes event_url (full URL), referrer_host, source, country, device_type, browser, os, event_name, and event_time_utc.

​
v1.0.5

​
April 7, 2026

  • include_events parameter on Get Contact — Added include_events to the Get Contact endpoint. When set to 1, the response includes an events array containing the contact’s full journey — all conversions and touchpoints sorted by most recent first. Conversion events include event_name, amount, event_url, order_id, order_name, channel (browser/server), and integration. Touchpoint events include source, touchpoint_url, referrer_url, and the full ad hierarchy (ad_name, adset_name, campaign_name, account_name).
  • hide_direct_touchpoints parameter on Get Contact — Added hide_direct_touchpoints (default 1) to the Get Contact endpoint. When include_events=1, direct touchpoints are excluded by default. Set to 0 to include them.

​
v1.0.4

​
March 19, 2026

  • use_custom_field_labels parameter — Added use_custom_field_labels to the List Contacts and Get Contact endpoints. When set to 1, custom field keys use user-defined labels (e.g. "Customer Age") instead of raw column names (e.g. "profile_field_1"). Fields without a configured label retain their raw column name.

​
v1.0.3

​
February 27, 2026

  • Ad hierarchy fields on List Events — Added ad_name, adset_id, adset_name, campaign_id, campaign_name, account_id, and account_name as requestable fields on the List Events endpoint. These fields require sources to be provided and return the ad, ad set, campaign, and account data from the attributed touchpoint.

​
v1.0.2

​
February 19, 2026

  • include_all_emails parameter — Added include_all_emails to the List Contacts and Create Contact Export endpoints. When set to 1, returns all email addresses associated with a contact, including emails from merged profiles.

​
v1.0.1

​
February 17, 2026

  • Custom fields on Create Event — The Create Event endpoint now accepts custom profile fields (profile_field_1 through profile_field_30) as root-level properties. Fields 1-15 accept text, 16-25 accept numbers (string or number), 26-30 accept dates.
  • event_url field — Added event_url as a requestable field on the List Events and Create Event Export endpoints. Returns the full URL where the event occurred.

​
v1.0.0

​
Initial release