# SendGrid + Krokul CRM

Yes. Krokul CRM integrates with SendGrid. A won deal, a new document or a paid invoice in Krokul sends a SendGrid dynamic template e-mail to the contact, and the SendGrid Event Webhook reports delivery, opens, clicks, bounces and unsubscribes back to the same deal and contact. Krokul contacts also stay on the Marketing Contacts lists you choose. The link runs through the Krokul app in Zapier, Make, n8n and Albato or through the Krokul API and webhooks.

**Status:** Via API and webhooks. **Automation platforms:** Zapier, Make, n8n, Albato.

## What your team gets

### Krokul contacts on Marketing Contacts lists

When a contact is created or changed in Krokul, the connector upserts it through the SendGrid Marketing Contacts API with the e-mail, the name and the list IDs you mapped. The Krokul contact UUID travels as external_id. SendGrid answers with a job ID and finishes the import in the background.

### Deal events send dynamic template e-mails

You link a Krokul event, such as a won deal or a paid invoice, to a SendGrid dynamic template. Krokul calls Mail Send with the template ID, fills dynamic_template_data with the deal title, amount, document number and manager name, and puts the deal UUID into custom_args. A comment on the deal records which template left and to whom.

### Deliveries, opens and clicks on the deal

SendGrid posts events in batches to the Event Webhook, and each event carries the custom_args from the original message. Krokul reads the deal UUID from them and adds delivered, open and click events to the deal timeline. The manager sees that the client opened the offer before calling.

### Bounces, spam reports and unsubscribes mark the contact

Events of type bounce, dropped, spamreport, unsubscribe and group_unsubscribe put a mark on the Krokul contact with the reason SendGrid gave. A bounce also creates a task to check the address. Krokul then skips that contact in later template sends from the same event rule.

## What moves between SendGrid and Krokul

| SendGrid | Krokul | Direction | When |
|---|---|---|---|
| Marketing contact (external_id, list_ids) | Contact | Krokul → SendGrid | A contact is created or changed |
| Mail Send with template_id and dynamic_template_data | Won deal, document or paid invoice | Krokul → SendGrid | The Krokul event fires |
| Event Webhook delivered, open, click | Activity on the deal | SendGrid → Krokul | SendGrid processes the message |
| Event Webhook bounce, dropped | Mark and task on the contact | SendGrid → Krokul | The message cannot be delivered |
| Event Webhook spamreport, unsubscribe, group_unsubscribe | Mark on the contact | SendGrid → Krokul | The recipient opts out |
| custom_args (deal UUID) | Deal reference | Krokul → SendGrid → Krokul | Every template send |

## How to connect today

### Krokul app in Zapier, Make, n8n or Albato

1. Connect the Krokul app with a Krokul API key and the SendGrid app with a SendGrid API key.
2. From the Krokul trigger Contact Created, call Create or Update Contact in Zapier, Add or Update a Contact (New) in Make or New\Update contact in Albato.
3. From the Krokul trigger Deal Won or Invoice Paid, call Send Email in Zapier, Mail Send in Albato or the Mail operation of the n8n SendGrid node with your template.

### Custom flow through the Krokul API and webhooks

1. Create a SendGrid API key with Mail Send and Marketing access. In Krokul, issue an API key scoped to contacts, deals and activities.
2. Subscribe a Krokul webhook to contact.created, card.won and invoice.paid, check x-crm-signature, then call PUT /v3/marketing/contacts or POST /v3/mail/send with the deal UUID in custom_args.
3. Turn on the signed Event Webhook in SendGrid and verify the ECDSA signature on every batch.
4. For each event, deduplicate by sg_event_id, find the contact with contact/api-find and write activity/api-create on the deal from custom_args.

**Triggers:** Watch new Recipients (Legacy); Watch new Lists (Legacy).

**Actions:** Send Email; Create or Update Contact; Find List by Name; Add or Update a Contact (New); Add Emails to Global Suppression; Mail Send; Search Contacts by Emails.

### For integrators

The SendGrid Event Webhook posts a JSON array of events, each with sg_event_id for deduplication and sg_message_id for the message. A signed webhook carries an ECDSA signature in X-Twilio-Email-Event-Webhook-Signature with its timestamp in a second header, and OAuth with client credentials is available as well. SendGrid warns against personal data in custom_args, so Krokul passes only the deal UUID. Names stay out. On the Krokul side, contact/api-find resolves the recipient and the delivery log replays a failed step.

[API documentation](https://app.krokul.com/api/v1/docs)

## Questions and answers

### Does Krokul integrate with SendGrid?

Yes. Krokul integrates with SendGrid through the Krokul app in Zapier, Make, n8n and Albato and through its API and webhooks, for contacts, template e-mail and delivery events.

### How do SendGrid events find the right deal?

Krokul adds the deal UUID to custom_args on every message. SendGrid returns custom_args with each Event Webhook event, so opens and clicks land on the deal that sent the e-mail.

### Does Krokul stop sending to an address that bounced?

Yes. A bounce or dropped event marks the contact in Krokul, and the event rules skip a marked contact. SendGrid also keeps its own suppression list for that address.

### Which templates can Krokul use?

SendGrid dynamic templates, with IDs that start with d-. The template design lives in SendGrid, and Krokul sends only the template ID and the values for its fields.

## Limits

Templates, sender domains, IP reputation and suppression groups are managed in SendGrid. Contact upserts in SendGrid run as background jobs, so a new contact appears on the list a short time after Krokul sends it.

## Related services

- [Postmark](https://krokul.com/en/integrations/postmark/index.md)
- [Brevo](https://krokul.com/en/integrations/brevo/index.md)
- [Mailchimp](https://krokul.com/en/integrations/mailchimp/index.md)
- [Twilio](https://krokul.com/en/integrations/twilio/index.md)
- [SendPulse](https://krokul.com/en/integrations/sendpulse/index.md)
- [ActiveCampaign](https://krokul.com/en/integrations/activecampaign/index.md)

[Email marketing](https://krokul.com/en/integrations/category/email-marketing/index.md)

SendGrid is a trademark of Twilio Inc. Krokul is not affiliated with SendGrid.

Updated: 2026-10-15

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs