With our API, you can submit data to our various engines to process the business logic according to your settings. A great way of putting data in the system is by using our Survey API to submit data to forms.
Start out by setting up a new form in PeopleVine and then create your replicate HTML version of that form (if you search for it, there's an article on how to leverage HAPI to generate a form's HTML).
Once your form is setup, you can now get your API application and credentials ready. Go to the company menu and click on API Credentials and API Applications to set them up. Then ensure you have an API user too. In the end, you should be able to create your AUTH object as such:
API Username – XXXX
API Password – XXXX
API Key - XXXX
Username - XXXX
Password - XXXX
Company_no - XXXX
When looking to submit data to our forms engine, you can reference the API details below:
API Docs: http://composeapi.com/api_fields.aspx?company_no=1&method_no=352
Endpoint: https://api.peoplevine.com/survey.asmx/answerSurvey
Sample Object to Include in Answers
{"survey_no": 3402, "survey_field_no": 11798, "survey_answer": "Jane Doe", "response_id": "<GUID>" }
Sample Call
{"answers": [{"survey_no": 123, "survey_field_no": 567890, "survey_answer": "Jane Doe", "response_id": "<GUID>" },{"survey_no": 1234, "survey_field_no": 678901, "survey_answer": "Sample Company", "response_id": "<GUID>" }], "auth": {"api_username": "", "api_password": "", "api_key": "", "company_no": 0, "username": "", "password": "" } }
Make sure the response_ID value is the same for all your answers. This will allow us to group the data into a single response.
When looking to submit data to our CRM, you can reference the API details below:
API Docs: http://composeapi.com/api_fields.aspx?company_no=1&method_no=6
API Endpoint: https://api.peoplevine.com/customer.asmx/registerCustomer
"auth": {"api_username": "", "api_password": "", "api_key": "", "company_no": 0, "username": "", "password": "" }, "customer": {"email": "", "mobile_number": "", "first_name": "", "customer_type": "customer", "customer_status": "active", “attributes”: [{“attribute_value”: “Value Here”, “attribute_type”: “Group Name Here”}] } }
Sample Object
"customer" {
"email" 'xyz@abc.com',
"opt_in_email" true,
"attributes" [{
"attribute_value" "VALUE HERE",
"attribute_type" "GROUP NAME HERE"
}]
}