Skip to content

Commit b8ea721

Browse files
author
Nick Campbell
committed
Clarify wording of docs
1 parent 6ce2f03 commit b8ea721

File tree

1 file changed

+24
-18
lines changed
  • src/connections/destinations/catalog/actions-attio

1 file changed

+24
-18
lines changed

src/connections/destinations/catalog/actions-attio/index.md

Lines changed: 24 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,11 @@ hide-boilerplate: true
55

66
{% include content/plan-grid.md name="actions" %}
77

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.
910

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.
1113

1214
## Getting started
1315

@@ -28,20 +30,25 @@ events.
2830
both a Person and User and links them together. If you only need to assert either a Person
2931
or User, you should configure [Assert Record](#assert-record) instead.*
3032

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.
3335

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.
3640

3741
> info ""
3842
> To use the User standard object, you'll need to make sure it's activated first. Visit
3943
> your [Workspace Settings > Objects](https://app.attio.com/_/settings/data/objects) page
4044
> and click the "Activate" button next to the Users object.
4145
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.
4552

4653
For example, we could set some additional properties on the Person using these Mapping
4754
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
7885
both a Company and Workspace and links them together. If you only need to assert either a
7986
Company or Workspace, you should configure [Assert Record](#assert-record) instead.*
8087

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.
8490

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.
8894

8995
> info ""
9096
> To use the Workspace standard object, you'll need to make sure it's activated first. Visit
9197
> your [Workspace Settings > Objects](https://app.attio.com/_/settings/data/objects) page
9298
> and click the "Activate" button next to the Workspaces object.
9399
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:
95101

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
98104

99105
You can specify additional attributes to be mapped on the **Edit Mapping** page.
100106

0 commit comments

Comments
 (0)