AMambivo
CRM Service Calls

Post Leads

Changed on

Create a new lead.

Adds a lead record to the CRM. Only name is required; all other fields are optional.

Request Body (LeadRequest):

  • name (required): Full name of the lead.
  • email (optional): Email address (stored as primary email).
  • phone (optional): Phone number (stored as primary phone).
  • source (default: "Unknown"): Marketing source. Values: Google, Facebook, Youtube, Reddit, Snapchat, Craigslist, Yelp, Linkedin, Incoming-Call, SMS, Referral, Bing, Yahoo, Nextdoor, Unknown, TikTok, Instagram, Billboard Ad.
  • status (default: "assigned"): Lead status. Values: open, assigned, attempted, contacted, meeting-setup, disqualified, incorrect.
  • comments (optional): Initial notes.
  • tags (optional): Up to 10 tags.
  • employer_name, profession, title, website (optional): Profile fields.
  • ssn (optional): Encrypted at rest.
  • birth_year, birth_month, birth_day (optional): Date of birth components.
  • decision_date (optional): Unix epoch timestamp.
  • business_need_description (optional): Free-text business need.
  • social_dict_list (optional): Social profiles, e.g. [{"type": "linkedin", "url": "..."}].

Response: The created lead object.

post/crm/leads

Request

Request body

namestring required
emailstring nullable
sourcestring nullable

Possible values: Google, Facebook, Youtube, Reddit, Snapchat, Craigslist, Yelp, Linkedin, Incoming-Call, SMS, Referral, Bing, Yahoo, Nextdoor, Unknown, TikTok, Instagram, Billboard Ad

phonestring nullable
commentsstring nullable
statusstring nullable

Possible values: open, assigned, attempted, contacted, meeting-setup, disqualified, incorrect

tagsstring[] nullable

List of tags (maximum 10 tags allowed)

employer_namestring nullable

Company name

professionstring nullable

Occupation

titlestring nullable

Title, indexed for search

ssnstring nullable

SSN - encrypted at rest (format: XXX-XX-XXXX or XXXXXXXXX)

websitestring nullable

URL, maps to vCard

birth_yearinteger nullable

4-digit year (e.g., 1985)

birth_monthinteger nullable

Birth month 1-12

birth_dayinteger nullable

Birth day 1-31

decision_dateinteger nullable

Unix epoch timestamp (seconds)

business_need_descriptionstring nullable

Free text for business need

social_dict_listobject[] nullable

List of social profiles, e.g. [{"type": "linkedin", "url": "https://linkedin.com/in/..."}]

Response

Successful Response

idstring required
first_namestring nullable required
last_namestring nullable required
namestring required
statusstring required
marketing_sourcestring nullable
created_datestring nullable required
updated_datestring nullable required
status_updated_datestring nullable required
tagsstring[] nullable
social_dict_listobject[] nullable
is_convertedboolean

Whether lead has been converted to contact

contact_idstring nullable

Contact ID if converted

has_dealboolean

Whether a deal/opportunity exists

deal_stagestring nullable

Current deal stage if exists

deal_idstring nullable

Deal/Opportunity ID if exists

value_of_salenumber nullable

Value of sale for the deal if exists

close_datestring nullable

Close date of the deal in ISO 8601 format

Changes

  • 165a6d16a9a0Revision changes
    • breaking

      removed the required property from the response with the status

    • warning

      the / request property's maxLength was set to 5000

    • warning

      the / request property's maxLength was set to 254

    • warning

      the request property's maxLength was set to 500

    • warning

      the / request property's maxLength was set to 20

    • warning

      the / request property's maxLength was set to 100

    • warning

      the / request property's maxLength was set to 50

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property email_list list-of-types was narrowed by removing types string from media type application/json of response 200

    • info

      response property phone_list list-of-types was narrowed by removing types string from media type application/json of response 200

    • info

      added the required property to the response with the status