Codat · Schema

Read completed webhook

Unified_API

Properties

Name Type Description
id string Unique identifier of the event.
eventType string The type of event.
generatedDate object The date time in UTC the event was generated in Codat.
payload object
View JSON Schema on GitHub

JSON Schema

codat-readcompletedwebhook-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ReadCompletedWebhook",
  "title": "Read completed webhook",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "example": "743ec94a-8aa4-44bb-8bd4-e1855ee0e74b",
      "description": "Unique identifier of the event."
    },
    "eventType": {
      "type": "string",
      "description": "The type of event."
    },
    "generatedDate": {
      "$ref": "#/components/schemas/DateTime",
      "description": "The date time in UTC the event was generated in Codat."
    },
    "payload": {
      "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/readCompletedWebhookPayload"
    }
  },
  "definitions": {
    "readCompletedWebhookPayload": {
      "title": "Read result webhook payload",
      "type": "object",
      "properties": {
        "referenceCompany": {
          "$ref": "#/components/schemas/Company/definitions/companyReference"
        },
        "modifiedFromDate": {
          "$ref": "#/components/schemas/DateTime",
          "description": "The date time in UTC when the data types were last fetched and input into Codat's cache.",
          "nullable": true
        },
        "dataTypes": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/dataTypeReadSummary"
          }
        }
      }
    },
    "dataTypeReadSummary": {
      "title": "Summary of data type reads",
      "type": "object",
      "properties": {
        "connectionId": {
          "$ref": "#/components/parameters/connectionId/schema"
        },
        "dataType": {
          "$ref": "#/components/schemas/DataStatus/properties/dataType"
        },
        "recordsModified": {
          "type": "boolean",
          "example": false,
          "description": "`True` if records have been created, updated or deleted in Codat's cache."
        },
        "status": {
          "$ref": "#/components/schemas/PullOperation/properties/status"
        },
        "issues": {
          "type": "array",
          "nullable": true,
          "description": "A array of issues encountered during a data read.",
          "items": {
            "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/issue"
          }
        }
      }
    },
    "customProductReadCompleteWebhook": {
      "title": "Read completed webhook",
      "type": "object",
      "properties": {
        "id": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/properties/id"
        },
        "eventType": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/properties/eventType"
        },
        "generatedDate": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/properties/generatedDate"
        },
        "payload": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/customProductReadCompleteWebhookPayload"
        }
      }
    },
    "customProductReadCompleteWebhookPayload": {
      "title": "Read result webhook payload",
      "type": "object",
      "properties": {
        "referenceCompany": {
          "$ref": "#/components/schemas/Company/definitions/companyReference"
        },
        "modifiedFromDate": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/readCompletedWebhookPayload/properties/modifiedFromDate"
        },
        "dataTypes": {
          "type": "array",
          "description": "Contains all data types configured for the product or a subset of data types defined in the manual refresh call.",
          "items": {
            "type": "object",
            "title": "Summary of data type reads",
            "properties": {
              "connectionId": {
                "$ref": "#/components/parameters/connectionId/schema"
              },
              "dataType": {
                "$ref": "#/components/schemas/DataStatus/properties/dataType"
              },
              "recordsModified": {
                "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/dataTypeReadSummary/properties/recordsModified"
              },
              "status": {
                "$ref": "#/components/schemas/PullOperation/properties/status"
              },
              "issues": {
                "type": "array",
                "nullable": true,
                "description": "A array of issues encountered during a data read.",
                "items": {
                  "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/issue"
                }
              }
            }
          }
        }
      }
    },
    "issue": {
      "title": "Issue",
      "type": "object",
      "description": "Details of a problem encountered during a data read.",
      "properties": {
        "type": {
          "type": "string",
          "description": "The type of issue.",
          "example": "warning.validation"
        },
        "message": {
          "type": "string",
          "description": "A message describing the issue.",
          "example": "Something doesn't look right about these accounts from Xero. You can see more information in the logs."
        },
        "links": {
          "title": "Links",
          "type": "object",
          "properties": {
            "logs": {
              "type": "string",
              "description": "A link to the validation logs, providing details on any errors or warnings encountered.",
              "example": "https://api.codat.io/companies/0498e921-9b53-4396-a412-4f2f5983b0a2/sync/{datasetId}/validation"
            },
            "portal": {
              "type": "string",
              "description": "A link to the company's past data read history in the Codat portal.",
              "example": "https://app.codat.io/companies/0498e921-9b53-4396-a412-4f2f5983b0a2/pull-history"
            },
            "readMore": {
              "type": "string",
              "description": "A link to Codat's documentation with additional information on how to troubleshoot this issue.",
              "example": "https://docs.codat.io/using-the-api/get-data-troubleshooting#warning.validation"
            }
          }
        }
      }
    }
  }
}