JSON Post Guide

the json post lead provider type allows you to send lead data to ampeducator using a json payload over an http post request this is ideal if you are integrating with systems or applications that can send structured json data — such as custom applications, server to server integrations, or modern form builders once configured, incoming json posts will automatically create new prospects in ampeducator step 1 add a new json post lead provider go to prospects / lead providers click the green add lead provider button set the provider type to json post enter a provider name that clearly identifies the source (e g , open house app json ) a unique id will be automatically generated you can edit it if you wish, but once saved, it cannot be changed (optional) add a description click add to continue you will then be taken to the profile page to configure the details step 2 configure the details after you add the json post lead provider, you'll be taken to the details page here, you’ll set up how incoming lead data is processed and routed top information and lead provider url at the top of the page, you’ll see important notes about how json post works json post processes http posts containing a json payload to create new prospects in ampeducator you must post your data to the lead provider url provided ampeducator will respond with a json object that includes success – whether the prospect was successfully added messages – any warnings or errors log – the processing log details query – a map of parsed data from the request prospect – the created prospectobject if successful restrict to ips is available if you want to limit incoming posts to certain trusted ip addresses json in parameter (new) by default, ampeducator expects the json payload in the body of the post request if you select json in parameter , ampeducator will instead look for the json data inside a specific query parameter lead assignment and notifications below the instructions, you’ll configure lead handling provider type set to json post (locked) provider name and description editable if needed default location assign all incoming leads to a location default agent (optional) pre assign an agent if desired adm advisor assign choose round robin or fixed advisor assignment default country set a country if your json payload does not always include it notifications email adm advisor / sms adm advisor enable to notify the assigned advisor when a new prospect arrives add adm advisor event automatically create a follow up event event title customize the event label (e g , follow up with json lead ) email notifications to / sms notifications to add others to receive alerts about new leads if needed security and data format options there are two optional settings available to help control who can submit leads and how incoming json data is handled restrict to ips add one or more ip addresses if you want to restrict submissions to trusted sources only when used, only requests coming from the listed ips will be accepted if left blank, submissions from any ip will be allowed json in parameter by default, ampeducator expects the json data to be posted in the body of the request if your system sends the json as part of a query parameter instead, check this box when selected, ampeducator will extract the json from the specified parameter instead of the body in most cases, restrict to ips is optional and json in parameter should remain unchecked unless your system requires it next steps once your lead provider is set up, continue with configuring docid\ rqweigkeyw6tp90z2ru2k these tabs work very similarly across all lead provider types and allow you to automate follow ups, map incoming fields, and review submissions