Creating Webhook Endpoints

​

What You Need

1. A URL that can receive POST requests — Your server endpoint
2. HTTPS — Required for security
3. 200 OK response — Endpoint must acknowledge receipt

​

Creating an Endpoint

​

Step 1: Navigate to Webhooks

​

Step 2: Click Create

​

Step 3: Configure Endpoint

​

Step 4: Save

​

Endpoint Requirements

​

HTTPS Required

​

Respond with 200

// Example Node.js endpoint
app.post('/webhooks/atoms', (req, res) => {
  const payload = req.body;
  
  // Process the webhook...
  processWebhook(payload);
  
  // Acknowledge receipt
  res.status(200).send('OK');
});

​

Timeout Handling

1. Acknowledge immediately
2. Process asynchronously

​

Signing and Verification

1. Set a Secret when creating the endpoint
2. Atoms signs payloads with this secret
3. Your endpoint verifies the signature

​

Testing Your Endpoint

​

Before Connecting

1. Create your endpoint on your server
2. Test it can receive POST requests
3. Verify it returns 200

​

After Creating in Atoms

1. Assign endpoint to an agent (Webhook Tab)
2. Select events to subscribe
3. Make a test call
4. Check your endpoint received the data

​

Multiple Endpoints

​

Troubleshooting

​

What’s Next