Chilkat Online Tools

Objective-C / DocuSign REST API / Creates a custom tab.

Back to Collection Items

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

// Use this online tool to generate code from sample JSON: Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "font": "sample string 1",
//   "bold": "sample string 2",
//   "italic": "sample string 3",
//   "underline": "sample string 4",
//   "fontColor": "sample string 5",
//   "fontSize": "sample string 6",
//   "anchor": "sample string 7",
//   "anchorXOffset": "sample string 8",
//   "anchorYOffset": "sample string 9",
//   "anchorUnits": "sample string 10",
//   "anchorIgnoreIfNotPresent": "sample string 11",
//   "anchorMatchWholeWord": "sample string 12",
//   "anchorCaseSensitive": "sample string 13",
//   "anchorHorizontalAlignment": "sample string 14",
//   "paymentItemCode": "sample string 15",
//   "paymentItemDescription": "sample string 16",
//   "paymentItemName": "sample string 17",
//   "height": "sample string 18",
//   "width": "sample string 19",
//   "customTabId": "sample string 20",
//   "initialValue": "sample string 21",
//   "includedInEmail": "sample string 22",
//   "disableAutoSize": "sample string 23",
//   "concealValueOnDocument": "sample string 24",
//   "locked": "sample string 25",
//   "required": "sample string 26",
//   "shared": "sample string 27",
//   "collaborative": "sample string 28",
//   "requireInitialOnSharedChange": "sample string 29",
//   "requireAll": "sample string 30",
//   "items": [
//     "sample string 1"
//   ],
//   "tabLabel": "sample string 31",
//   "maximumLength": "sample string 32",
//   "scaleValue": "sample string 33",
//   "name": "sample string 34",
//   "type": "sample string 35",
//   "validationMessage": "sample string 36",
//   "validationPattern": "sample string 37",
//   "lastModifiedByUserId": "sample string 38",
//   "lastModifiedByDisplayName": "sample string 39",
//   "lastModified": "sample string 40",
//   "createdByUserId": "sample string 41",
//   "createdByDisplayName": "sample string 42",
//   "editable": "sample string 43",
//   "mergeField": {
//     "configurationType": "sample string 1",
//     "path": "sample string 2",
//     "writeBack": "sample string 3",
//     "allowSenderToEdit": "sample string 4",
//     "row": "sample string 5"
//   },
//   "stampType": "sample string 44",
//   "selected": "sample string 45"
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"font" value: @"sample string 1"];
[json UpdateString: @"bold" value: @"sample string 2"];
[json UpdateString: @"italic" value: @"sample string 3"];
[json UpdateString: @"underline" value: @"sample string 4"];
[json UpdateString: @"fontColor" value: @"sample string 5"];
[json UpdateString: @"fontSize" value: @"sample string 6"];
[json UpdateString: @"anchor" value: @"sample string 7"];
[json UpdateString: @"anchorXOffset" value: @"sample string 8"];
[json UpdateString: @"anchorYOffset" value: @"sample string 9"];
[json UpdateString: @"anchorUnits" value: @"sample string 10"];
[json UpdateString: @"anchorIgnoreIfNotPresent" value: @"sample string 11"];
[json UpdateString: @"anchorMatchWholeWord" value: @"sample string 12"];
[json UpdateString: @"anchorCaseSensitive" value: @"sample string 13"];
[json UpdateString: @"anchorHorizontalAlignment" value: @"sample string 14"];
[json UpdateString: @"paymentItemCode" value: @"sample string 15"];
[json UpdateString: @"paymentItemDescription" value: @"sample string 16"];
[json UpdateString: @"paymentItemName" value: @"sample string 17"];
[json UpdateString: @"height" value: @"sample string 18"];
[json UpdateString: @"width" value: @"sample string 19"];
[json UpdateString: @"customTabId" value: @"sample string 20"];
[json UpdateString: @"initialValue" value: @"sample string 21"];
[json UpdateString: @"includedInEmail" value: @"sample string 22"];
[json UpdateString: @"disableAutoSize" value: @"sample string 23"];
[json UpdateString: @"concealValueOnDocument" value: @"sample string 24"];
[json UpdateString: @"locked" value: @"sample string 25"];
[json UpdateString: @"required" value: @"sample string 26"];
[json UpdateString: @"shared" value: @"sample string 27"];
[json UpdateString: @"collaborative" value: @"sample string 28"];
[json UpdateString: @"requireInitialOnSharedChange" value: @"sample string 29"];
[json UpdateString: @"requireAll" value: @"sample string 30"];
[json UpdateString: @"items[0]" value: @"sample string 1"];
[json UpdateString: @"tabLabel" value: @"sample string 31"];
[json UpdateString: @"maximumLength" value: @"sample string 32"];
[json UpdateString: @"scaleValue" value: @"sample string 33"];
[json UpdateString: @"name" value: @"sample string 34"];
[json UpdateString: @"type" value: @"sample string 35"];
[json UpdateString: @"validationMessage" value: @"sample string 36"];
[json UpdateString: @"validationPattern" value: @"sample string 37"];
[json UpdateString: @"lastModifiedByUserId" value: @"sample string 38"];
[json UpdateString: @"lastModifiedByDisplayName" value: @"sample string 39"];
[json UpdateString: @"lastModified" value: @"sample string 40"];
[json UpdateString: @"createdByUserId" value: @"sample string 41"];
[json UpdateString: @"createdByDisplayName" value: @"sample string 42"];
[json UpdateString: @"editable" value: @"sample string 43"];
[json UpdateString: @"mergeField.configurationType" value: @"sample string 1"];
[json UpdateString: @"mergeField.path" value: @"sample string 2"];
[json UpdateString: @"mergeField.writeBack" value: @"sample string 3"];
[json UpdateString: @"mergeField.allowSenderToEdit" value: @"sample string 4"];
[json UpdateString: @"mergeField.row" value: @"sample string 5"];
[json UpdateString: @"stampType" value: @"sample string 44"];
[json UpdateString: @"selected" value: @"sample string 45"];

// Adds the "Authorization: Bearer {{accessToken}}" header.
http.AuthToken = @"{{accessToken}}";
[http SetRequestHeader: @"Accept" value: @"application/json"];

CkoHttpResponse *resp = [http PostJson3: @"https://domain.com/v2.1/accounts/{{accountId}}/tab_definitions" contentType: @"application/json" json: json];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

NSLog(@"%d",[resp.StatusCode intValue]);
NSLog(@"%@",resp.BodyStr);

Curl Command

curl -X POST
	-H "Accept: application/json"
	-H "Authorization: Bearer {{accessToken}}"
	-d '{
  "font": "sample string 1",
  "bold": "sample string 2",
  "italic": "sample string 3",
  "underline": "sample string 4",
  "fontColor": "sample string 5",
  "fontSize": "sample string 6",
  "anchor": "sample string 7",
  "anchorXOffset": "sample string 8",
  "anchorYOffset": "sample string 9",
  "anchorUnits": "sample string 10",
  "anchorIgnoreIfNotPresent": "sample string 11",
  "anchorMatchWholeWord": "sample string 12",
  "anchorCaseSensitive": "sample string 13",
  "anchorHorizontalAlignment": "sample string 14",
  "paymentItemCode": "sample string 15",
  "paymentItemDescription": "sample string 16",
  "paymentItemName": "sample string 17",
  "height": "sample string 18",
  "width": "sample string 19",
  "customTabId": "sample string 20",
  "initialValue": "sample string 21",
  "includedInEmail": "sample string 22",
  "disableAutoSize": "sample string 23",
  "concealValueOnDocument": "sample string 24",
  "locked": "sample string 25",
  "required": "sample string 26",
  "shared": "sample string 27",
  "collaborative": "sample string 28",
  "requireInitialOnSharedChange": "sample string 29",
  "requireAll": "sample string 30",
  "items": [
    "sample string 1"
  ],
  "tabLabel": "sample string 31",
  "maximumLength": "sample string 32",
  "scaleValue": "sample string 33",
  "name": "sample string 34",
  "type": "sample string 35",
  "validationMessage": "sample string 36",
  "validationPattern": "sample string 37",
  "lastModifiedByUserId": "sample string 38",
  "lastModifiedByDisplayName": "sample string 39",
  "lastModified": "sample string 40",
  "createdByUserId": "sample string 41",
  "createdByDisplayName": "sample string 42",
  "editable": "sample string 43",
  "mergeField": {
    "configurationType": "sample string 1",
    "path": "sample string 2",
    "writeBack": "sample string 3",
    "allowSenderToEdit": "sample string 4",
    "row": "sample string 5"
  },
  "stampType": "sample string 44",
  "selected": "sample string 45"
}'
https://domain.com/v2.1/accounts/{{accountId}}/tab_definitions

Postman Collection Item JSON

{
  "name": "Creates a custom tab.",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      },
      {
        "key": "Authorization",
        "value": "Bearer {{accessToken}}"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n  \"font\": \"sample string 1\",\n  \"bold\": \"sample string 2\",\n  \"italic\": \"sample string 3\",\n  \"underline\": \"sample string 4\",\n  \"fontColor\": \"sample string 5\",\n  \"fontSize\": \"sample string 6\",\n  \"anchor\": \"sample string 7\",\n  \"anchorXOffset\": \"sample string 8\",\n  \"anchorYOffset\": \"sample string 9\",\n  \"anchorUnits\": \"sample string 10\",\n  \"anchorIgnoreIfNotPresent\": \"sample string 11\",\n  \"anchorMatchWholeWord\": \"sample string 12\",\n  \"anchorCaseSensitive\": \"sample string 13\",\n  \"anchorHorizontalAlignment\": \"sample string 14\",\n  \"paymentItemCode\": \"sample string 15\",\n  \"paymentItemDescription\": \"sample string 16\",\n  \"paymentItemName\": \"sample string 17\",\n  \"height\": \"sample string 18\",\n  \"width\": \"sample string 19\",\n  \"customTabId\": \"sample string 20\",\n  \"initialValue\": \"sample string 21\",\n  \"includedInEmail\": \"sample string 22\",\n  \"disableAutoSize\": \"sample string 23\",\n  \"concealValueOnDocument\": \"sample string 24\",\n  \"locked\": \"sample string 25\",\n  \"required\": \"sample string 26\",\n  \"shared\": \"sample string 27\",\n  \"collaborative\": \"sample string 28\",\n  \"requireInitialOnSharedChange\": \"sample string 29\",\n  \"requireAll\": \"sample string 30\",\n  \"items\": [\n    \"sample string 1\"\n  ],\n  \"tabLabel\": \"sample string 31\",\n  \"maximumLength\": \"sample string 32\",\n  \"scaleValue\": \"sample string 33\",\n  \"name\": \"sample string 34\",\n  \"type\": \"sample string 35\",\n  \"validationMessage\": \"sample string 36\",\n  \"validationPattern\": \"sample string 37\",\n  \"lastModifiedByUserId\": \"sample string 38\",\n  \"lastModifiedByDisplayName\": \"sample string 39\",\n  \"lastModified\": \"sample string 40\",\n  \"createdByUserId\": \"sample string 41\",\n  \"createdByDisplayName\": \"sample string 42\",\n  \"editable\": \"sample string 43\",\n  \"mergeField\": {\n    \"configurationType\": \"sample string 1\",\n    \"path\": \"sample string 2\",\n    \"writeBack\": \"sample string 3\",\n    \"allowSenderToEdit\": \"sample string 4\",\n    \"row\": \"sample string 5\"\n  },\n  \"stampType\": \"sample string 44\",\n  \"selected\": \"sample string 45\"\n}"
    },
    "url": {
      "raw": "{{baseUrl}}/v2.1/accounts/{{accountId}}/tab_definitions",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "v2.1",
        "accounts",
        "{{accountId}}",
        "tab_definitions"
      ],
      "variable": [
        {
          "key": "accountId",
          "value": "{{accountId}}"
        }
      ]
    },
    "description": "Creates a tab with pre-defined properties, such as a text tab with a certain font type and validation pattern. Users can access the custom tabs when sending documents through the DocuSign web application.\n\nCustom tabs can be created for approve, checkbox, company, date, date signed, decline, email, email address, envelope ID, first name, formula, full name, initial here, last name, list, note, number, radio, sign here, signer attachment, SSN, text, title, and zip tabs."
  },
  "response": [
  ]
}