> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# Add Connect configuration for organization

POST https://api-d.docusign.net/Management/v2/organizations/{organizationId}/connect
Content-Type: application/json

Creates a new [Organization-Level Connect configuration](/platform/webhooks/connect/org-level-connect/) using the definition provided in the request body. See [Create an Organization-Level Connect configuration](/platform/webhooks/connect/org-level-connect/#create-an-organization-level-connect-configuration) for an example definition.

Required scopes: `connect_org_config_write_api`

Reference: https://developers.docusign.com/docs/admin-api/reference/organization/connect/createorganizationconnectconfig

## Authentication

- `Authorization` header (bearer token, required) — OAuth2 Access code Grant

## Servers

- `https://api-d.docusign.net/Management` (Demo, default)
- `https://api.docusign.net/Management` (Production)

## Request

### Path parameters

- `organizationId` (string, required) — The GUID ID of the organization within which the Organization-Level Connect configuration will be created.

### Body (application/json)

This endpoint expects an OrganizationConnectConfigurationRequest.

- `connectId` (string, optional)
- `configurationType` (string, optional)
- `allowEnvelopePublish` (string, optional)
- `urlToPublishTo` (string, optional)
- `deliveryMode` (string, optional)
- `events` (list of string, optional)
- `associatedFilterSelection` (string, optional)
- `groupIds` (list of string, optional)
- `accountIds` (list of string, optional)
- `userIds` (list of string, optional)
- `name` (string, optional)
- `signMessageWithX509Certificate` (string, optional)
- `includeOAuth` (string, optional)
- `includeHMAC` (string, optional)
- `pausePublish` (string, optional)
- `eventData` (ConnectEventData, optional)

## Response

### 200

OK

- `connectId` (string, optional)
- `configurationType` (string, optional)
- `allowEnvelopePublish` (string, optional)
- `urlToPublishTo` (string, optional)
- `deliveryMode` (string, optional)
- `events` (list of string, optional)
- `associatedFilterSelection` (string, optional)
- `accountIds` (list of string, optional)
- `userIds` (list of string, optional)
- `groupIds` (list of string, optional)
- `name` (string, optional)
- `signMessageWithX509Certificate` (string, optional)
- `includeOAuth` (string, optional)
- `includeHMAC` (string, optional)
- `pausePublish` (string, optional)
- `eventData` (ConnectEventData, optional)

## Types

### ConnectEventData

- `version` (string, optional)
- `includeData` (list of string, optional)

## Examples

**Request**

```json
{}
```

**Response**

```json
{
  "connectId": "00000000-0000-0000-0000-000000000000",
  "configurationType": "string",
  "allowEnvelopePublish": "string",
  "urlToPublishTo": "string",
  "deliveryMode": "string",
  "events": [
    "string"
  ],
  "associatedFilterSelection": "string",
  "accountIds": [
    "string"
  ],
  "userIds": [
    "string"
  ],
  "groupIds": [
    "string"
  ],
  "name": "string",
  "signMessageWithX509Certificate": "string",
  "includeOAuth": "string",
  "includeHMAC": "string",
  "pausePublish": "string",
  "eventData": {
    "version": "string",
    "includeData": [
      "string"
    ]
  }
}
```