v1
latestOpenAPI 3.1.02026-08-069158174.8 KBCRM Service Calls
Get Contacts Created
Retrieve contacts created within a time window (default: last 4 hours).
Returns contacts whose created_ts falls within the specified date range. If neither start_date nor end_date is provided, defaults to a rolling 4-hour window ending at the current UTC time.
Time-based filtering (start_date / end_date):
- Format: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
- Default window (no params): last 4 hours
Example requests:
- Contacts created in the last 4 hours (default): GET /contacts/created
- Contacts created in the last 7 days: GET /contacts/created?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z
- Google contacts created since March 1st: GET /contacts/created?start_date=2026-03-01&match_filter_dict={"lead_source": "Google"}
Other Query Parameters:
- match_filter_dict (optional): JSON-encoded MongoDB filter for non-date fields. Filterable fields: status, lead_source, name, tags, employer_name, profession, title.
Response: Array of contact objects (same schema as GET /contacts).
get/crm/contacts/created
Query parameters
match_filter_dictstring
start_datestring nullable
Start of date range in ISO 8601 format. Defaults to now − 4 hours.
Start of date range in ISO 8601 format. Defaults to now − 4 hours.
end_datestring nullable
End of date range in ISO 8601 format. Defaults to now.
End of date range in ISO 8601 format. Defaults to now.
Response
Successful Response