Add Custom Field

Adds new Custom Field to the project.

Role

Administrator 
Project Administrator 

Method

POST 

URL

/api/v2/projects/:projectIdOrKey/customFields 

URL parameters

Parameter Name Type Description
projectIdOrKey String Project ID or Project Key

Form parameters

Content-Type:application/x-www-form-urlencoded 
Parameter Name Type Description
typeId (Required) Number Type ID of Custom field
1: Text
2: Sentence
3: Number
4: Date
5: Single list
6: Multiple list
7: Checkbox
8: Radio
name (Required) String Name
applicableIssueTypes[]
(Multiple)
Number Type ID to enable Custom fields
empty=enable for all issue types
description String Description
required Boolean True to make the Custom field required

Added parameters (Number)

Parameter Name Type Description
min Number minimum value
max Number maximum value
initialValue Number initial value
unit String unit

Added parameters (Date)

Parameter Name Type Description
min String minimum (yyyy-MM-dd)
max String maximum (yyyy-MM-dd)
initialValueType Number 1:today, 2: today + initialShift, 3:specified day
initialDate String initial (yyyy-MM-dd)
initialShift Number date differences

Added parameters (List)

Parameter Name Type Description
items[]
(Multiple)
String list
allowInput Boolean true to allow “Other” input form
allowAddItem Boolean true to allow add list

Response example

Status Line / Response Header

HTTP/1.1 200 OK 
Content-Type:application/json;charset=utf-8 

Response Body

{ 
    "id": 2, 
    "projectId": 5,
    "typeId": 1, 
    "name": "Attribute for Bug", 
    "description": "", 
    "required": false, 
    "applicableIssueTypes": [1] 
}