Chilkat Online Tools

Objective-C / DocuSign eSignature REST API / Creates a connect configuration for the specified account.

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.

// {
//   "connectId": "sample string 1",
//   "configurationType": "sample string 2",
//   "urlToPublishTo": "sample string 3",
//   "name": "sample string 4",
//   "allowEnvelopePublish": "sample string 5",
//   "enableLog": "sample string 6",
//   "includeDocuments": "sample string 7",
//   "includeCertificateOfCompletion": "sample string 8",
//   "requiresAcknowledgement": "sample string 9",
//   "signMessageWithX509Certificate": "sample string 10",
//   "useSoapInterface": "sample string 11",
//   "includeTimeZoneInformation": "sample string 12",
//   "includeHMAC": "sample string 13",
//   "includeEnvelopeVoidReason": "sample string 14",
//   "includeSenderAccountasCustomField": "sample string 15",
//   "envelopeEvents": "sample string 16",
//   "recipientEvents": "sample string 17",
//   "userIds": "sample string 18",
//   "soapNamespace": "sample string 19",
//   "allUsers": "sample string 20",
//   "includeCertSoapHeader": "sample string 21",
//   "includeDocumentFields": "sample string 22"
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"connectId" value: @"sample string 1"];
[json UpdateString: @"configurationType" value: @"sample string 2"];
[json UpdateString: @"urlToPublishTo" value: @"sample string 3"];
[json UpdateString: @"name" value: @"sample string 4"];
[json UpdateString: @"allowEnvelopePublish" value: @"sample string 5"];
[json UpdateString: @"enableLog" value: @"sample string 6"];
[json UpdateString: @"includeDocuments" value: @"sample string 7"];
[json UpdateString: @"includeCertificateOfCompletion" value: @"sample string 8"];
[json UpdateString: @"requiresAcknowledgement" value: @"sample string 9"];
[json UpdateString: @"signMessageWithX509Certificate" value: @"sample string 10"];
[json UpdateString: @"useSoapInterface" value: @"sample string 11"];
[json UpdateString: @"includeTimeZoneInformation" value: @"sample string 12"];
[json UpdateString: @"includeHMAC" value: @"sample string 13"];
[json UpdateString: @"includeEnvelopeVoidReason" value: @"sample string 14"];
[json UpdateString: @"includeSenderAccountasCustomField" value: @"sample string 15"];
[json UpdateString: @"envelopeEvents" value: @"sample string 16"];
[json UpdateString: @"recipientEvents" value: @"sample string 17"];
[json UpdateString: @"userIds" value: @"sample string 18"];
[json UpdateString: @"soapNamespace" value: @"sample string 19"];
[json UpdateString: @"allUsers" value: @"sample string 20"];
[json UpdateString: @"includeCertSoapHeader" value: @"sample string 21"];
[json UpdateString: @"includeDocumentFields" value: @"sample string 22"];

// 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}}/connect" 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 '{
  "connectId": "sample string 1",
  "configurationType": "sample string 2",
  "urlToPublishTo": "sample string 3",
  "name": "sample string 4",
  "allowEnvelopePublish": "sample string 5",
  "enableLog": "sample string 6",
  "includeDocuments": "sample string 7",
  "includeCertificateOfCompletion": "sample string 8",
  "requiresAcknowledgement": "sample string 9",
  "signMessageWithX509Certificate": "sample string 10",
  "useSoapInterface": "sample string 11",
  "includeTimeZoneInformation": "sample string 12",
  "includeHMAC": "sample string 13",
  "includeEnvelopeVoidReason": "sample string 14",
  "includeSenderAccountasCustomField": "sample string 15",
  "envelopeEvents": "sample string 16",
  "recipientEvents": "sample string 17",
  "userIds": "sample string 18",
  "soapNamespace": "sample string 19",
  "allUsers": "sample string 20",
  "includeCertSoapHeader": "sample string 21",
  "includeDocumentFields": "sample string 22"
}'
https://domain.com/v2.1/accounts/{{accountId}}/connect

Postman Collection Item JSON

{
  "name": "Creates a connect configuration for the specified account.",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      },
      {
        "key": "Authorization",
        "value": "Bearer {{accessToken}}"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n  \"connectId\": \"sample string 1\",\n  \"configurationType\": \"sample string 2\",\n  \"urlToPublishTo\": \"sample string 3\",\n  \"name\": \"sample string 4\",\n  \"allowEnvelopePublish\": \"sample string 5\",\n  \"enableLog\": \"sample string 6\",\n  \"includeDocuments\": \"sample string 7\",\n  \"includeCertificateOfCompletion\": \"sample string 8\",\n  \"requiresAcknowledgement\": \"sample string 9\",\n  \"signMessageWithX509Certificate\": \"sample string 10\",\n  \"useSoapInterface\": \"sample string 11\",\n  \"includeTimeZoneInformation\": \"sample string 12\",\n  \"includeHMAC\": \"sample string 13\",\n  \"includeEnvelopeVoidReason\": \"sample string 14\",\n  \"includeSenderAccountasCustomField\": \"sample string 15\",\n  \"envelopeEvents\": \"sample string 16\",\n  \"recipientEvents\": \"sample string 17\",\n  \"userIds\": \"sample string 18\",\n  \"soapNamespace\": \"sample string 19\",\n  \"allUsers\": \"sample string 20\",\n  \"includeCertSoapHeader\": \"sample string 21\",\n  \"includeDocumentFields\": \"sample string 22\"\n}"
    },
    "url": {
      "raw": "{{baseUrl}}/v2.1/accounts/{{accountId}}/connect",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "v2.1",
        "accounts",
        "{{accountId}}",
        "connect"
      ],
      "variable": [
        {
          "key": "accountId",
          "value": "{{accountId}}",
          "type": "string"
        }
      ]
    },
    "description": "Creates a DocuSign Custom Connect definition for your account. DocuSign Connect enables the sending of real-time data updates to external applications. These updates are generated by user transactions as the envelope progresses through actions to completion. The Connect Service provides updated information about the status of these transactions and returns updates that include the actual content of document form fields. Be aware that, these updates might or might not include the document itself. For more information about Connect, see the [ML:DocuSign Connect Service Guide].\n\n###### Note: Connect must be enabled for your account to use this function. This cannot be used to set up Connect configurations for Salesforce or eOriginal."
  },
  "response": [
  ]
}