/field-mappings

GET

/crm/v1/field-mappings

GET

/api/crm/v1/field-mappings

1 curl https://api.merge.dev/api/crm/v1/field-mappings \
2      -H "X-Account-Token: X-Account-Token" \
3      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "Account": [
3     {
4       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
5       "is_integration_wide": true,
6       "target_field": {
7         "name": "example_target_field_name",
8         "description": "this is a example description of a target field",
9         "is_organization_wide": true
10       },
11       "remote_field": {
12         "remote_key_name": "example_remote_field_key",
13         "schema": {
14           "type": "string"
15         },
16         "remote_endpoint_info": {
17           "method": "GET",
18           "url_path": "/example-url-path",
19           "field_traversal_path": [
20             "example_remote_field_key"
21           ]
22         }
23       },
24       "jmes_path": "[0].example_jmes_path",
25       "advanced_mapping_expression": "$[0].example_jsonata"
26     }
27   ],
28   "Contact": [
29     {
30       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
31       "is_integration_wide": true,
32       "target_field": {
33         "name": "example_target_field_name",
34         "description": "this is a example description of a target field",
35         "is_organization_wide": true
36       },
37       "remote_field": {
38         "remote_key_name": "example_remote_field_key",
39         "schema": {
40           "type": "string"
41         },
42         "remote_endpoint_info": {
43           "method": "GET",
44           "url_path": "/example-url-path",
45           "field_traversal_path": [
46             "example_remote_field_key"
47           ]
48         }
49       },
50       "jmes_path": "[0].example_jmes_path",
51       "advanced_mapping_expression": "$[0].example_jsonata"
52     }
53   ],
54   "Lead": [
55     {
56       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
57       "is_integration_wide": true,
58       "target_field": {
59         "name": "example_target_field_name",
60         "description": "this is a example description of a target field",
61         "is_organization_wide": true
62       },
63       "remote_field": {
64         "remote_key_name": "example_remote_field_key",
65         "schema": {
66           "type": "string"
67         },
68         "remote_endpoint_info": {
69           "method": "GET",
70           "url_path": "/example-url-path",
71           "field_traversal_path": [
72             "example_remote_field_key"
73           ]
74         }
75       },
76       "jmes_path": "[0].example_jmes_path",
77       "advanced_mapping_expression": "$[0].example_jsonata"
78     }
79   ],
80   "Note": [
81     {
82       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
83       "is_integration_wide": true,
84       "target_field": {
85         "name": "example_target_field_name",
86         "description": "this is a example description of a target field",
87         "is_organization_wide": true
88       },
89       "remote_field": {
90         "remote_key_name": "example_remote_field_key",
91         "schema": {
92           "type": "string"
93         },
94         "remote_endpoint_info": {
95           "method": "GET",
96           "url_path": "/example-url-path",
97           "field_traversal_path": [
98             "example_remote_field_key"
99           ]
100         }
101       },
102       "jmes_path": "[0].example_jmes_path",
103       "advanced_mapping_expression": "$[0].example_jsonata"
104     }
105   ],
106   "Opportunity": [
107     {
108       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
109       "is_integration_wide": true,
110       "target_field": {
111         "name": "example_target_field_name",
112         "description": "this is a example description of a target field",
113         "is_organization_wide": true
114       },
115       "remote_field": {
116         "remote_key_name": "example_remote_field_key",
117         "schema": {
118           "type": "string"
119         },
120         "remote_endpoint_info": {
121           "method": "GET",
122           "url_path": "/example-url-path",
123           "field_traversal_path": [
124             "example_remote_field_key"
125           ]
126         }
127       },
128       "jmes_path": "[0].example_jmes_path",
129       "advanced_mapping_expression": "$[0].example_jsonata"
130     }
131   ],
132   "Stage": [
133     {
134       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
135       "is_integration_wide": true,
136       "target_field": {
137         "name": "example_target_field_name",
138         "description": "this is a example description of a target field",
139         "is_organization_wide": true
140       },
141       "remote_field": {
142         "remote_key_name": "example_remote_field_key",
143         "schema": {
144           "type": "string"
145         },
146         "remote_endpoint_info": {
147           "method": "GET",
148           "url_path": "/example-url-path",
149           "field_traversal_path": [
150             "example_remote_field_key"
151           ]
152         }
153       },
154       "jmes_path": "[0].example_jmes_path",
155       "advanced_mapping_expression": "$[0].example_jsonata"
156     }
157   ],
158   "User": [
159     {
160       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
161       "is_integration_wide": true,
162       "target_field": {
163         "name": "example_target_field_name",
164         "description": "this is a example description of a target field",
165         "is_organization_wide": true
166       },
167       "remote_field": {
168         "remote_key_name": "example_remote_field_key",
169         "schema": {
170           "type": "string"
171         },
172         "remote_endpoint_info": {
173           "method": "GET",
174           "url_path": "/example-url-path",
175           "field_traversal_path": [
176             "example_remote_field_key"
177           ]
178         }
179       },
180       "jmes_path": "[0].example_jmes_path",
181       "advanced_mapping_expression": "$[0].example_jsonata"
182     }
183   ],
184   "Task": [
185     {
186       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
187       "is_integration_wide": true,
188       "target_field": {
189         "name": "example_target_field_name",
190         "description": "this is a example description of a target field",
191         "is_organization_wide": true
192       },
193       "remote_field": {
194         "remote_key_name": "example_remote_field_key",
195         "schema": {
196           "type": "string"
197         },
198         "remote_endpoint_info": {
199           "method": "GET",
200           "url_path": "/example-url-path",
201           "field_traversal_path": [
202             "example_remote_field_key"
203           ]
204         }
205       },
206       "jmes_path": "[0].example_jmes_path",
207       "advanced_mapping_expression": "$[0].example_jsonata"
208     }
209   ],
210   "Engagement": [
211     {
212       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
213       "is_integration_wide": true,
214       "target_field": {
215         "name": "example_target_field_name",
216         "description": "this is a example description of a target field",
217         "is_organization_wide": true
218       },
219       "remote_field": {
220         "remote_key_name": "example_remote_field_key",
221         "schema": {
222           "type": "string"
223         },
224         "remote_endpoint_info": {
225           "method": "GET",
226           "url_path": "/example-url-path",
227           "field_traversal_path": [
228             "example_remote_field_key"
229           ]
230         }
231       },
232       "jmes_path": "[0].example_jmes_path",
233       "advanced_mapping_expression": "$[0].example_jsonata"
234     }
235   ]
236 }

Get all Field Mappings for this Linked Account. Field Mappings are mappings between third-party Remote Fields and user defined Merge fields. Learn more.

Get all Field Mappings for this Linked Account. Field Mappings are mappings between third-party Remote Fields and user defined Merge fields. [Learn more](https://docs.merge.dev/supplemental-data/field-mappings/overview/).

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Query parameters

exclude_remote_field_metadatabooleanOptional

If true, remote fields metadata is excluded from each field mapping instance (i.e. remote_fields.remote_key_name and remote_fields.schema will be null). This will increase the speed of the request since these fields require some calculations.

Response

Accountlist of objects or null

Contactlist of objects or null

Leadlist of objects or null

Notelist of objects or null

Opportunitylist of objects or null

Stagelist of objects or null

Userlist of objects or null

Tasklist of objects or null

Engagementlist of objects or null

Authentication

Headers

Query parameters

Response