Ingest API
The Ingest API lets you create/update people and submit events from your app's backend directly to Encharge. The API exposes a single endpoint.
See this documentation as a Postman Collection.
Get your write key for the Ingest API in Your Account.
post/
post
https://ingest.encharge.io/v1/
Create/update person or record events for existing people.
Request
Response
Request
Headers
X-Encharge-Token
required
string
Write key for your account.
Content-Type
required
string
Content type must be application/json
Body Parameters
user
required
object
Properties for the current user.
email or userId is required to uniquely identify this person. Any other fields in properties will be added as custom fields to people.name
required
string
Name of your event. If you are using the API to create/update people, you can use "identify" as event name.
properties
optional
object
Properties for this event.
Response
200: OK
​
​
Pass the IP of the user (as property ip in the user object) to automatically populate the user country and timezone.
​
Last updated 2 months ago