Shape Software API | Add New Leads - Shape Software - Automate your business!


Shape Software API



Add New Leads

POST /add/new/lead

To create a new lead, send an authorized POST request to


Create leads in Shape with first name, last name, and email address + additional desired field names in the request body. To get a list of supported field names, please see the section below titled “How to Get Field Names.”

Parameter — Lead’s first name.

Parameter — Lead’s last name.

Parameter — Lead’s email address.

Parameter — Lead’s phone number (this will be mapped to “Mobile Phone” or “Primary Phone” depending on your CRM industry template).

Parameter — Lead origination source Ex: LeadPops. If no source exists, one will be created in the “Marketing Sources” settings page.

Parameter — Record type is important when source is not provided, Record types can be fetch from /api/get/lead/typesrecordtype

Parameter — To get a list of supported field names, please see the section below titled “How to Get Field Names.”

Request Header

The authentication token should be passed in the request header for every API request.

Content-Type: application/json

Request Body

JSON request body formatting example:

  "firstname": "First",
  "lastname": "Last",
  "email": "",
  "phone": "5555555555",
  "source": "LeadPops",


Upon success, the server returns HTTP codes and messages in the header with some additional elements and properties that are set by the server, such as id.

  "message": "Record successfully received.",
  "recordId": XXXX

How to Get Field Names

Field names can be found within your CRM System’s settings pages under: Settings > Marketing Sources > Edit Any Marketing Source > Campaign Source Post URL Instructions.


After navigating to the marketing sources settings page and opening up a campaign, scroll to the bottom of the page to the “Campaign Source Post URL Instructions” section. Here, you will find a searchable table with a breakdown of all of the field names available for use. These field names can also be exported to a CSV via the “Export” dropdown.