Upsert API key credentials for a connector

Set or rotate the API key credentials for this connector. If credentials already exist, they are replaced and the connection is re-established. The credential payload is required; this endpoint will not delete credentials.

post

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

connector_idstringRequired

The unique identifier of the connector

Header parameters

X-API-Versionstring · enumOptional

Meta Business Agent API version

Possible values:

Body

application/json

API key credentials to upsert

Responses

200

The updated connector with API key metadata

application/json

A single connector

auth_typestring · enumRequiredPossible values:

base_urlstringRequired

descriptionstringRequired

idstringRequiredExample: 1234567890

namestringRequired

400

Bad request

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Too many requests

application/json

500

Server error

application/json

post/agent_connectors/{connector_id}/upsertApiKey

HTTPcURLJavaScriptPython

POST /agent_connectors/{connector_id}/upsertApiKey HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 224

{
  "api_key_config": {
    "body_params": [
      {
        "field_name": "text",
        "prefix": "text",
        "value": "text"
      }
    ],
    "headers": [
      {
        "field_name": "text",
        "prefix": "text",
        "value": "text"
      }
    ],
    "query_params": [
      {
        "field_name": "text",
        "prefix": "text",
        "value": "text"
      }
    ]
  }
}

{
  "auth_config": {
    "api_key": {
      "body_params": [
        {
          "field_name": "text",
          "prefix": "text",
          "value": "text"
        }
      ],
      "headers": [
        {
          "field_name": "text",
          "prefix": "text",
          "value": "text"
        }
      ],
      "query_params": [
        {
          "field_name": "text",
          "prefix": "text",
          "value": "text"
        }
      ]
    },
    "oauth2_client_credentials": {
      "client_id": "text",
      "client_secret": "text",
      "scopes_to_request": [
        "text"
      ],
      "token_request_content_type": "text",
      "token_url": "text"
    }
  },
  "auth_type": "OAUTH2",
  "base_url": "text",
  "connection_status": {
    "error_message": "text",
    "status": "PENDING_OAUTH"
  },
  "description": "text",
  "id": "1234567890",
  "mtls_config": {
    "ca_certificate": "text",
    "client_certificate": "text",
    "expires_at": 1,
    "fingerprint": "text",
    "has_certificate": true,
    "subject": "text"
  },
  "name": "text",
  "user_auth_injection_config": {
    "field_name": "text",
    "location": "body",
    "prefix": "text"
  }
}