Overview

This API allows businesses to upload and manage contacts, companies, and engagement data in Conversion programmatically. All endpoints require proper authentication and follow RESTful conventions.

Base URL

https://pub-api.conversion.ai/api

Authentication

All requests must include your API key in the header:

X-API-Key: YOUR_API_KEY

Response Format

All API responses follow this standard format:

Success Response:

Standard JSON format.

Error Response:

{
  "message": "User is not found."
}

HTTP Response Codes

Code	Status	Description
200	OK	Success
400	Bad Request	Your request was invalid
401	Unauthorized	Invalid or missing API key
403	Forbidden	Your API key does not have permissions for the requested resource
404	Not Found	The requested resource does not exist
429	Too Many Requests	You've hit our API rate limits
500	Server Error	Something went wrong on Conversion's end

Best Practices

1. Batch Operations: Use batch endpoints when uploading multiple records to reduce API calls

2. Error Handling: Always check the response code is 200 before processing response data

3. Validation: Validate email formats and required fields before sending requests

4. Monitoring: Monitor API response times and error rates for optimal performance