Sby SendGrid
Add or update contacts
Queues up to 30,000 contacts, or 6 MB, to be created or updated in Marketing Campaigns and returns a job ID.
Description
Processing is asynchronous: a `202` means queued, and the `job_id` shows the import status. To update a contact, send all of its existing identifiers; fields you leave out keep their values. Create custom fields before you set them.
upsert-contacts.md
Add or update contacts
Queues up to 30,000 contacts, or 6 MB, to be created or updated in Marketing Campaigns and returns a job ID.
Processing is asynchronous: a 202 means queued, and the job_id shows the
import status. To update a contact, send all of its existing identifiers;
fields you leave out keep their values. Create custom fields before you set
them.
Set up
Use the first option your agent supports.
API (official)
- Base URL: https://api.sendgrid.com
- Endpoint:
PUT /v3/marketing/contacts - Auth: send the header
Authorization: Bearer $SENDGRID_API_KEY - Get a key: https://app.sendgrid.com/settings/api_keys
- Docs: https://www.twilio.com/docs/sendgrid/api-reference
Before doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | PUT /v3/marketing/contacts | API key in $SENDGRID_API_KEY | Docs |