Webhooks & API

dVersum offers webhooks and a REST API for integration with other systems like n8n, Zapier, or your own software.

Outgoing Webhooks

Outgoing webhooks automatically send notifications to external systems when specific events occur in dVersum.

Creating a Webhook

1. Go to Settings > Integrations
2. Click on Webhooks
3. Click on New Webhook
4. Fill in:
   • Name - Descriptive name
   • URL - Target URL to be called
   • Events - Which events should trigger it
5. Save

Available Events

The most important events:

• Invoices: invoice.created, invoice.sent, invoice.paid, invoice.overdue
• Quotes: quote.created, quote.accepted, quote.rejected
• Clients: client.created, client.updated
• Tasks: task.created, task.completed
• Projects: project.created
• Time: time_entry.created

Full event list in the API Docs

Incoming Webhooks

Incoming webhooks allow external systems to send data to dVersum.

Creating an Incoming Webhook

1. Go to Settings > Integrations
2. Click on Incoming Webhooks
3. Click on New Incoming Webhook
4. Select the Permissions:
   • Create/edit/delete tasks
   • Create/edit projects
   • Create/edit clients
   • Create time entries
   • Create invoices
   • Create quotes
5. Optional: IP Whitelist for additional security
6. Save

API Key

After creation, you receive an API Key (e.g., ik_live_abc123...).

Available Endpoints

With incoming webhooks you can:

• Tasks create and update
• Clients create and edit
• Time entries record
• Invoices and Quotes create

All endpoints with request/response examples in the API Docs

Integration with n8n

n8n is an open-source automation platform.

dVersum > n8n (Outgoing)

1. Create a webhook in dVersum
2. In n8n: Add a Webhook Trigger
3. Copy the n8n webhook URL
4. Enter this URL in dVersum

n8n > dVersum (Incoming)

1. Create an incoming webhook in dVersum
2. In n8n: Add an HTTP Request node
3. Method: POST
4. URL: https://dversum.com/api/v1/webhooks/incoming/tasks
5. Header: Authorization: Bearer YOUR_API_KEY
6. Body: JSON with task data

Example Workflow

Scenario: New email > Task in dVersum

1. Trigger: Email received (Gmail/IMAP)
2. Action: HTTP Request to dVersum
3. Payload: Subject > Title, Content > Description

Integration with Zapier

Zapier enables integrations without programming.

dVersum Trigger in Zapier

1. Create a new Zap
2. Select Webhook by Zapier as trigger
3. Select Catch Hook
4. Copy the Zapier webhook URL
5. Create a webhook in dVersum with this URL

dVersum Action in Zapier

1. Select Webhook by Zapier as action
2. Select POST
3. URL: dVersum incoming webhook URL
4. Headers: Authorization Bearer Key
5. Data: JSON data

Error Handling

Webhook Retry

Outgoing webhooks are automatically retried on failure:

• 1st retry: After 1 minute
• 2nd retry: After 5 minutes
• 3rd retry: After 30 minutes
• 4th retry: After 2 hours

Webhook Log

View all webhook calls:

1. Go to Settings > Webhooks
2. Click on View Log
3. You will see:
   • Timestamp
   • Event
   • Status (Success/Error)
   • Response code
   • Payload

Security

Best Practices

1. Use HTTPS - Only encrypted connections
2. Verify signature - Verify the webhook signature
3. IP Whitelist - Restrict access
4. Minimal permissions - Only grant necessary permissions
5. Rotate keys - Change API keys regularly

Disabling a Webhook

In case of security issues:

1. Go to the webhook settings
2. Click on Disable
3. The webhook will stop sending data

Rate Limits

When exceeded, you will receive status code 429.