This FAQ will help you with how to update lead information through API. You can update lead through API internally or a 3rd party lead vendor can update the lead using Request Query String.
(Note: First is you need to add Authorization Token, click here to see complete details.
How to update lead internally:
Note: You must know the Lead ID of the lead that you would like to update.
Note: If you're updating a lead to move it to another list and the lead is currently inserted to the hopper, that lead will be automatically removed from the hopper.
From the Admin page, click on API and select Leads.
From the Leads API, click on Update Lead tab.
Check the Arguments to update lead.
Note: When creating a Request Query String, make sure that you have values for the required fields.
Click on Test Request tab.
Below you will be able to see all the fields in your account, enter a value on the fields along with the lead id to update the lead information.
Select the correct Authorization Token for this API from the dropdown box.
Sample Test Lead Update:
Lead ID: 19584200
From the API update lead through test request, enter the values in the field that you want to update.
- Putting a valid List ID will move the lead to that list.
- Leaving a field blank, will delete the value of that field if ever there's any.
Click on Run button below to execute and update the field.
Below you will be able to see the system's response
To see the Query String, put a check on Show Query. Click Copy to Clipboard button if you would like to copy the Query String.
Search the Lead ID 19584200.
How to update lead by your lead vendor through API:
Note: 3rd party lead vendor should know the Lead ID that they will update.
From the Update Lead tab. Scroll down up to Request Query String.
Put a checkmark on Show Query.
Click on Copy to Clipboard and send this string to your lead vendor to update the lead in your account.
They will also receive a JSON Response on the lead that they updated.