You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/sources/catalog/cloud-apps/sendgrid/index.md
+12-16Lines changed: 12 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,8 +28,7 @@ To add the Sendgrid source to Segment, return to your Segment Workspace and foll
28
28
1. Navigate to **Connections > Catalog**, and search for "Sendgrid".
29
29
2. Click the "Sendgrid" source, and click **Add Source**. **Note**: This source only supports warehouses as a destination.
30
30
3. Give the source a meaningful name and (optional) add any labels to help you organize and filter your sources. Select all of the Warehouse destinations from the existing connections.
31
-
> info ""
32
-
> Segment recommends that you give your source a name that reflects the source itself as this name populates the schema name. For example, the source name `SendGrid` creates the schema `SendGrid`. You can add multiple instances if you have multiple SendGrid accounts.
31
+
> **Note**: Segment recommends that you give your source a name that reflects the source itself as this name populates the schema name. For example, the source name `SendGrid` creates the schema `SendGrid`. You can add multiple instances if you have multiple SendGrid accounts.
33
32
4. Add the [SendGrid API Key](#sendgrid-api-key) to connect Sendgrid to Segment. Click **Connect**.
34
33

35
34
5. Copy the auto-generated Webhook URL from Segment and paste it in your Sendgrid account. Navigate to **Settings > Mail Settings > Event Webhooks** and create a new event webhook.
@@ -40,12 +39,9 @@ To add the Sendgrid source to Segment, return to your Segment Workspace and foll
40
39
> 3.**Select the collections to sync**. The collections that you select will be synced from the start date.
41
40
7. Click **Finish** to complete connecting your Sendgrid source to Segment.
42
41
8. To set the date from which the sync should start, go to **Settings > Basic Settings**, and configure the start date.
43
-
> info ""
44
-
> Changing the start date after the first sync doesn't change anything unless a full manual sync is initiated.
45
-
>
46
-
> Changing the collections to be synced takes effect after the next sync. The previous data synced for any collection that has been unselected will be in the warehouse.
47
-
>
48
-
> The default value for Source Sync Schedule in 3 hours. To change the sync, schedule send a message to [[email protected]](mailto:[email protected]){:target="_blank”}.
42
+
> * Changing the start date after the first sync doesn't change anything unless a full manual sync is initiated.
43
+
> * Changing the collections to be synced takes effect after the next sync. The previous data synced for any collection that has been unselected will be in the warehouse.
44
+
> * The default value for Source Sync Schedule in 3 hours. To change the sync, schedule send a message to [[email protected]](mailto:[email protected]){:target="_blank”}.
49
45
9. Toggle **Enable source** on to start syncing data.
50
46
10. The first sync begins after you successfully create the source. To review the collections and number of rows synced, go to the **Overview** tab.
51
47
@@ -83,22 +79,22 @@ Collections are the groupings of resources Segment pulls from your source. In yo
83
79
| Collection | Type | Description |
84
80
| ------ | ------ | ------ |
85
81
| activity | Event | The union of all SendGrid **event** tables. Useful for creating funnels. |
86
-
|_open | Event | Recipient has opened the HTML message. Enable Open Tracking to get this type of event. |
87
-
| click | Event | Recipient clicked on a link within the message. Enable Click Tracking to get this type of event. |
82
+
|_open | Event | Recipient has opened the HTML message. Enable **Open Tracking** to get this type of event. |
83
+
| click | Event | Recipient clicked on a link within the message. Enable **Click Tracking** to get this type of event. |
88
84
| bounce | Event | Receiving server could not or would not accept message. |
89
85
| delivered | Event | Message has been successfully delivered to the receiving server. |
90
86
| processed | Event | Triggered when the email is processed. |
91
-
| dropped | Event | You may see the following drop reasons: Invalid SMTPAPI header, Spam Content (if spam checker app enabled), Unsubscribed Address, Bounced Address, Spam Reporting Address, Invalid, Recipient List over Package Quota |
87
+
| dropped | Event | You may see the following drop reasons: `Invalid SMTPAPI header`, `Spam Content` (if spam checker app enabled), `Unsubscribed Address`, `Bounced Address`, `Spam Reporting Address`, `Invalid`, `Recipient List over Package Quota`.|
| unsubscribe | Event | Recipient clicked on message's subscription management link. You need to enable Subscription Tracking for getting this type of event. |
89
+
| unsubscribe | Event | Recipient clicked on message's subscription management link. You need to enable **Subscription Tracking** for getting this type of event. |
94
90
| mc_contacts | Object | A sample of fifty latest contacts uploaded or linked from the list, returned from [Sendgrid](https://docs.sendgrid.com/api-reference/contacts/get-sample-contacts){:target="_blank"}. **Will only return data if you're using SendGrid's New Marketing Campaign features.**|
95
91
| mc_lists | Object | Lists returned from [Sendgrid Lists endpoint](https://docs.sendgrid.com/api-reference/lists/get-all-lists){:target="_blank"}. **Will only return data if you're using SendGrid's New Marketing Campaign features.**|
96
92
| mc_single_sends | Object | Single Sends with condensed details about each from [Sendgrid Single Sends endpoint](https://docs.sendgrid.com/api-reference/single-sends/get-all-single-sends){:target="_blank"}. **Will only return data if you're using SendGrid's New Marketing Campaign features.**|
| lists | Object |[Groups of contacts](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/contactdb.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data**|
99
-
| segments | Object |[Slices of lists](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/contactdb.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data**|
100
-
| recipients | Object | All contacts who have received an email, with information about their last activities and custom activities. [More Info](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/contactdb.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data**|
101
-
| campaigns | Object | All campaigns you've created in SendGrid. [More Info](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/campaigns.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data**|
94
+
| lists | Object |[Groups of contacts](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/contactdb.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data.**|
95
+
| segments | Object |[Slices of lists](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/contactdb.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data.**|
96
+
| recipients | Object | All contacts who have received an email, with information about their last activities and custom activities. For more information, see the [Sendgrid docs](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/contactdb.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data.**|
97
+
| campaigns | Object | All campaigns you've created in SendGrid. For more information, see the [Sendgrid docs](https://sendgrid.com/docs/API_Reference/Web_API_v3/Marketing_Campaigns/campaigns.html){:target="_blank”}. **Will only return data if you had Legacy Marketing Campaigns data.**|
0 commit comments