/target-fields

POST

/ticketing/v1/target-fields

POST

/api/ticketing/v1/target-fields

$ curl -X POST https://api.merge.dev/api/ticketing/v1/target-fields \
>      -H "X-Account-Token: X-Account-Token" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "employee_favorite_team",
>   "common_model": "Employee"
> }'

200Successful

1 {
2   "Ticket": [
3     {
4       "name": "example_target_field_name",
5       "description": "this is a example description of a target field",
6       "is_mapped": "true"
7     }
8   ],
9   "Comment": [
10     {
11       "name": "example_target_field_name",
12       "description": "this is a example description of a target field",
13       "is_mapped": "true"
14     }
15   ],
16   "Project": [
17     {
18       "name": "example_target_field_name",
19       "description": "this is a example description of a target field",
20       "is_mapped": "true"
21     }
22   ],
23   "Collection": [
24     {
25       "name": "example_target_field_name",
26       "description": "this is a example description of a target field",
27       "is_mapped": "true"
28     }
29   ],
30   "User": [
31     {
32       "name": "example_target_field_name",
33       "description": "this is a example description of a target field",
34       "is_mapped": "true"
35     }
36   ],
37   "Role": [
38     {
39       "name": "example_target_field_name",
40       "description": "this is a example description of a target field",
41       "is_mapped": "true"
42     }
43   ],
44   "Account": [
45     {
46       "name": "example_target_field_name",
47       "description": "this is a example description of a target field",
48       "is_mapped": "true"
49     }
50   ],
51   "Team": [
52     {
53       "name": "example_target_field_name",
54       "description": "this is a example description of a target field",
55       "is_mapped": "true"
56     }
57   ],
58   "Attachment": [
59     {
60       "name": "example_target_field_name",
61       "description": "this is a example description of a target field",
62       "is_mapped": "true"
63     }
64   ],
65   "Tag": [
66     {
67       "name": "example_target_field_name",
68       "description": "this is a example description of a target field",
69       "is_mapped": "true"
70     }
71   ],
72   "Contact": [
73     {
74       "name": "example_target_field_name",
75       "description": "this is a example description of a target field",
76       "is_mapped": "true"
77     }
78   ]
79 }

Create a new organization-wide Target Field. Target Fields are custom fields that your organization defines to collect supplemental data from integrations. Learn more.

Create a new organization-wide Target Field. Target Fields are custom fields that your organization defines to collect supplemental data from integrations. [Learn more](https://docs.merge.dev/supplemental-data/field-mappings/target-fields/).

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Request

This endpoint expects an object.

namestringRequired>=1 character

The name of the target field.

common_modelstringRequired>=1 character

The name of the Common Model to associate the target field with.

descriptionstringOptional>=1 characterDefaults to

The description of the target field.

Response

Ticketlist of objectsOptional

Commentlist of objectsOptional

Projectlist of objectsOptional

Collectionlist of objectsOptional

Userlist of objectsOptional

Rolelist of objectsOptional

Accountlist of objectsOptional

Teamlist of objectsOptional

Attachmentlist of objectsOptional

Taglist of objectsOptional

Contactlist of objectsOptional

Authentication

Headers

Request

Response