Function postConnection

Remarks

• For Cognito, the connectionId is the userPoolId.

---

📥 Request

Headers:

• Authorization: Bearer <access_token> (required)
• Content-Type: application/json or application/x-www-form-urlencoded (required)

Body:

• See PostConnectionRequest

Path Parameters:

• None

Query Parameters:

• None

---

📤 Response

• 201 Created – JSON stringified object representing the created connection. See Connection.

---

❗ Errors

Status Code	Meaning	When it Happens
400	Bad Request	Missing or invalid fields in request body
401	Unauthorized	Missing or invalid authentication token
500	Internal Server Error	Unexpected error

Error Response Format

{
  "error": "Detailed error message here"
}
Copy

---

📦 Examples

📥 Auth0 Request

POST /connections
{
  "connectionBody": {
    "name": "example-connection",
    "displayName": "Connection Name",
    "metadata": {
      "key": "value"
    },
  }
}
Copy

📥 Cognito Request

POST /connections
{
  "provider": "cognito-connection",
  "connectionBody": {
    "name": "example-connection",
    "metadata": {
      "key": "value"
    },
  }
}
Copy

📤 Response Example

{
  "connectionId": "connection_id",
  "name": "example-connection",
  "type": "connection_type",
  "status": "active|inactive",
  "createdAt": "2023-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T00:00:00Z",
  "metadata": {
    "key": "value"
  },
  "configuration": {
    "setting": "value"
  }
Copy

---