Generating an API Key
- Go to Settings → API Keys.
- Click Generate New Key.
- Enter a label (e.g., 'My Integration', 'Zapier Backup').
- Click Create.
- Copy the key immediately — it is shown only once. Store it securely.
Authentication
All API requests must include your API key in the request header:
- •Header name: X-API-Key
- •Value: your-api-key-here
- •Base URL: https://vedain.com/api/v1
Common Endpoints
- •GET /api/v1/leads — List leads (supports ?limit=50&page=1 pagination)
- •POST /api/v1/leads — Create a new lead (send JSON body with firstName, lastName, email, phone, etc.)
- •GET /api/v1/leads/{id} — Get a specific lead
- •PUT /api/v1/leads/{id} — Update a lead
- •GET /api/v1/contacts — List contacts
- •POST /api/v1/contacts — Create a contact
- •GET /api/v1/deals — List deals
Example: Creating a Lead via API
- •Method: POST
- •URL: https://vedain.com/api/v1/leads
- •Headers: X-API-Key: your-key, Content-Type: application/json
- •Body: {"firstName": "John", "lastName": "Smith", "email": "john@example.com", "phone": "9876543210", "leadSource": "API"}
Frequently Asked Questions
Where is the full API documentation?
Full API documentation is available at vedain.com/api/docs (or contact support for the latest API reference). It lists every endpoint, required and optional fields, and example requests and responses.
Is there a rate limit on API calls?
Yes. The default rate limit is 1,000 requests per minute per API key. If you need higher limits for bulk operations, contact Vedain support.
Can I use the API to bulk-import data?
Yes. Use the POST /api/v1/leads endpoint in a loop to create records programmatically. For very large datasets (10,000+ records), the CSV import in Settings → Import is faster and more reliable.
Ready to put this into practice?
Start your free 14-day trial of Vedain CRM — no credit card needed.
Start Free Trial