API Reference

Bulk Export Records

Export records by an ID list or a created-date range, selecting the fields to return.

POSThttps://secure-api.setshape.com/api/leads/bulk/export/{crmid}

Replace {crmid} with your Shape system ID — found on the API Integrations page. Every request also needs your auth header — see Using Shape APIs.

Body parameters

Select up to 500 IDs, or supply a createdDateRange. Date-range pages return 50 records each, up to page 200. fields is required.

Field Requirement Description
ids Conditional Array of up to 500 integer record IDs (or use createdDateRange).
createdDateRange Conditional Object with from, to, and pageNumber.
fields Required Array of account field mappings to return.

Example request

{
  "createdDateRange": {
    "from": "2024-02-01",
    "to": "2024-05-01",
    "pageNumber": 1
  },
  "fields": [
    "leadid",
    "recordtype",
    "createdDate",
    "firstname",
    "lastname",
    "email"
  ]
}