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/destinations/catalog/actions-attio/index.md
+24-18Lines changed: 24 additions & 18 deletions
Original file line number
Diff line number
Diff line change
@@ -5,9 +5,11 @@ hide-boilerplate: true
5
5
6
6
{% include content/plan-grid.md name="actions" %}
7
7
8
-
Powerful, flexible and data-driven, [Attio](https://attio.com) makes it easy to build the exact CRM that your business needs.
8
+
Powerful, flexible and data-driven, [Attio](https://attio.com) makes it easy to build the
9
+
exact CRM that your business needs.
9
10
10
-
This destination allows you to use your existing Segment events to create or update records in Attio, for example creating User objects from identify events.
11
+
This destination allows you to use your existing Segment events to create or update
12
+
records in Attio, for example creating User records from identify events.
11
13
12
14
## Getting started
13
15
@@ -28,20 +30,25 @@ events.
28
30
both a Person and User and links them together. If you only need to assert either a Person
29
31
or User, you should configure [Assert Record](#assert-record) instead.*
30
32
31
-
In Attio, a **Person**is an object which represents a human. People have names, email
32
-
addresses, Twitter profiles, email and calendar interactions, etc.
33
+
In Attio, a **Person** represents a human. People have names, email addresses, Twitter
34
+
profiles, email and calendar interactions, etc.
33
35
34
-
Meanwhile, a **User** is an object which represents how they exist in your product.
35
-
Users might have feature flags, permission levels, etc.
36
+
Meanwhile, a **User** is a user of your product. Users might have feature flags,
37
+
permission levels, etc. A Person can have multiple Users, for example if they exist in
38
+
different workspaces or have different sets of permissions, but are ultimately the same
39
+
Person.
36
40
37
41
> info ""
38
42
> To use the User standard object, you'll need to make sure it's activated first. Visit
39
43
> your [Workspace Settings > Objects](https://app.attio.com/_/settings/data/objects) page
40
44
> and click the "Activate" button next to the Users object.
41
45
42
-
This mapping only makes one assumption about your data, which is that it includes an email
43
-
address property. You can specify additional attributes to be mapped on the **Edit
44
-
Mapping** page.
46
+
This mapping makes the assumption that your Segment event includes two properties:
47
+
48
+
1. An `email_address` property, to create or update a Person
49
+
2. A `id` property, to create or update an associated User
50
+
51
+
You can specify additional attributes to be mapped on the **Edit Mapping** page.
45
52
46
53
For example, we could set some additional properties on the Person using these Mapping
47
54
Fields under "Additional Person attributes". The column on the left should contain
@@ -78,23 +85,22 @@ Create or update a **Company** using the provided domain, then create or update
78
85
both a Company and Workspace and links them together. If you only need to assert either a
79
86
Company or Workspace, you should configure [Assert Record](#assert-record) instead.*
80
87
81
-
In Attio, a **Company** is an object which can represent any of your customers, suppliers,
82
-
partners or competitors. Companies have names and domains, as well as enriched properties
83
-
like ARR or category.
88
+
In Attio, a **Company** can have names and domains, as well as enriched properties like
89
+
ARR or category.
84
90
85
-
Meanwhile, a **Workspace**is an object which represents how they might exist in your
86
-
product. Workspaces might have feature flags, billing configurations, customer support
87
-
representatives, etc.
91
+
Meanwhile, a **Workspace** represents a group of Users in your product. Workspaces might
92
+
have feature flags, billing configurations, customer support representatives, etc. A
93
+
Company can have many Workspaces.
88
94
89
95
> info ""
90
96
> To use the Workspace standard object, you'll need to make sure it's activated first. Visit
91
97
> your [Workspace Settings > Objects](https://app.attio.com/_/settings/data/objects) page
92
98
> and click the "Activate" button next to the Workspaces object.
93
99
94
-
This mapping makes the assumption that your data includes two properties:
100
+
This mapping makes the assumption that your Segment event includes two properties:
95
101
96
-
1. A `domain` property to create or update a Company
97
-
2. A `name` property, to create or update an associated Workspace
102
+
1. A `domain` property, to create or update a Company
103
+
2. A `id` property, to create or update an associated Workspace
98
104
99
105
You can specify additional attributes to be mapped on the **Edit Mapping** page.
0 commit comments