---
updatedAt: 2026-05-20T12:31:30.000Z
agentTools:
  projectIndex: https://docs.data.one/llms.txt
---

# Successful account connection by user

POSTed by D•One to the subscribed targetUrl after a user connects their bank account and Open Banking data for an account is ready for consumption. Emitted once per account.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "version": "v1",
    "title": "Webhooks",
    "description": "Endpoints relating to creating, managing and testing webhook subscriptions. These are only relevant for direct connection journey partners, for more details please see the guides on https://docs.data.one."
  },
  "webhooks": {
    "v1.account_transactions.user_initiated.succeeded": {
      "post": {
        "tags": [
          "Delivery payloads"
        ],
        "operationId": "eventAccountTransactionsUserInitiatedSucceeded",
        "summary": "Successful account connection by user",
        "description": "POSTed by D•One to the subscribed targetUrl after a user connects their bank account and Open Banking data for an account is ready for consumption. Emitted once per account.",
        "parameters": [
          {
            "$ref": "#/components/parameters/WebhookIdHeader"
          },
          {
            "$ref": "#/components/parameters/WebhookTimestampHeader"
          },
          {
            "$ref": "#/components/parameters/WebhookSignatureHeader"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Webhook event payload.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TransactionsUserInitiatedSuccessWebhookEvent"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Return a 2xx status within 5 seconds to acknowledge successful receipt."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api-sandbox.data.one",
      "description": "Hostname for sandbox API."
    }
  ],
  "components": {
    "parameters": {
      "WebhookIdHeader": {
        "name": "X-Webhook-Id",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid",
          "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
        },
        "description": "Unique identifier for this webhook event delivery. Matches `eventId` in the payload."
      },
      "WebhookTimestampHeader": {
        "name": "X-Webhook-Timestamp",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "format": "date-time",
          "example": "2023-01-01T10:00:00Z"
        },
        "description": "Time at which the webhook was generated. Matches `timestamp` in the payload."
      },
      "WebhookSignatureHeader": {
        "name": "X-Webhook-Signature",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "example": "sha256=8f434346648f6b96df89dda901c5176b10a6d83961dd3c1ac88b59b2dc327aa4"
        },
        "description": "HMAC SHA-256 signature of the payload, prefixed with `sha256=`."
      }
    },
    "schemas": {
      "CategorisationVersion": {
        "type": "string",
        "description": "Version of the D•One categorisation engine used to process transactions for the account.",
        "example": "43.0.0"
      },
      "TransactionsUserInitiatedSuccessWebhookPayload": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "format": "uuid",
            "description": "D•One user ID."
          },
          "accountId": {
            "type": "string",
            "format": "uuid",
            "description": "Account ID for which data is ready."
          },
          "categorisationVersion": {
            "$ref": "#/components/schemas/CategorisationVersion"
          }
        },
        "required": [
          "userId",
          "accountId",
          "categorisationVersion"
        ]
      },
      "TransactionsUserInitiatedSuccessWebhookEvent": {
        "type": "object",
        "properties": {
          "eventType": {
            "type": "string",
            "enum": [
              "v1.account_transactions.user_initiated.succeeded"
            ]
          },
          "eventId": {
            "type": "string",
            "format": "uuid",
            "description": "Unique identifier for this webhook event."
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid",
            "description": "Webhook subscription that triggered this delivery."
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "Time at which the event was generated."
          },
          "payload": {
            "$ref": "#/components/schemas/TransactionsUserInitiatedSuccessWebhookPayload"
          }
        },
        "required": [
          "eventType",
          "eventId",
          "subscriptionId",
          "timestamp",
          "payload"
        ],
        "example": {
          "eventType": "v1.account_transactions.user_initiated.succeeded",
          "eventId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "subscriptionId": "123e4567-e89b-12d3-a456-426614174000",
          "timestamp": "2023-01-01T10:00:00Z",
          "payload": {
            "userId": "f1e2d3c4-b5a6-9876-5432-109876543210",
            "accountId": "5ba48999-de7f-43be-8819-5edf27efac78",
            "categorisationVersion": "43.0.0"
          }
        }
      }
    }
  }
}
```