Knowledgebase

Add Custom Field

Method: POST
Endpoint: /api/addCustomField

Parameter

Parameter Type Required

Description

name string Yes Custom field name goes here
type int (default: 1) Yes Type of the custom field

1 = Text Field
2 = Multi-line Text Field
3 = Checkboxes
4 = Dropdown
5 = Radio Button
6 = Date Field
7 = JSON
values string No for type 1,2,6,7

Yes for type 3,4,5
Comma separated values
required 0, 1 (default: 0) No While adding a contact, do you want to make it a required additional field?

0 = Not required while adding a contact
1 = Required field while adding a contact
list_id int Yes ids of the contact lists to assign this field to them
field_order int Yes Position of the custom field which adding a contact
response 0, 1 (default: 0) No Get full response of the operation


Response Parameters

Parameter Type

Description

status JSON Success or Error
result JSON Result of the operation
response JSON Output of the operation


Example Request (CURL)

<?php
// Authentication
$api_token	=	'API_KEY'; // Mumara API Key (can be found in Settings -> API Key)
$domain		=	'http://www.anydomain.com'; // Your Mumara Domain Name

// API Endpoint
$endpoint	=	'/api/addCustomField';

//parameters
$params = [
    'name'          => 'Designation',
    'type'          => 'text',
    'field_order'   => '3',
    'list_id'       => '14',
    'response'      =>  1];

// Defining cURL Request
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,$domain.$endpoint);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_HTTPHEADER,
    array('Content-Type: application/json', 'Authorization: Bearer ' . $api_token));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Executing cURL
$output = curl_exec ($ch);

// Printing Output
echo "<pre>";
echo json_encode(json_decode($output),JSON_PRETTY_PRINT );

// Closing cURL
curl_close ($ch);
?>


Example Response (JSON)

 {
    "status": "success",
    "result": "Success: Custom field created successfully.",
    "response": {
        "id": 43,
        "name": "Designation",
        "tag": "designation",
        "type": "text",
        "is_default": 0,
        "is_required": 0,
        "options": null,
        "field_order": 3,
        "list_ids": "14",
        "user_id": 2,
        "created_at": "2019-05-15 07:14:43",
        "updated_at": "2019-05-15 07:14:43"
    }
 }
Status value of the success response will be "Success"


Example Error Response (JSON)

 {
    "status": "error",
    "result": {
        "values": [
            "Error: Missing required parameter, values"
        ]
    }
 }


Possible Errors

  • Invalid custom field name
  • Invalid contact list id
  • Invalid format
  • Access Denied
POST
/api/addCustomField
Try it out