createRecord

WRITE

Create one QuickBooks record from the object Intuit's API takes, under an operation key QuickBooks answers a replay with.

POST /api/v1/quickbooks/createRecord

curl -X POST '<your-host>/api/v1/quickbooks/createRecord' \
  -H 'Authorization: Bearer <api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "entity": "Customer",
    "record": {},
    "requestId": "string"
  }'

Response

{
  "entity": "Account",
  "id": "string",
  "requestId": "string"
}

Parameters

ParameterType

The QuickBooks entity, by the name Intuit's API gives it.

"Customer""Vendor""Account""Department""Class""Item""Invoice""CreditMemo""Payment""JournalEntry""Deposit""Bill"

The new record as Intuit's API takes it, without an Id or a SyncToken; a Payment applies itself to invoices through Line[].LinkedTxn.

The write's key, sent as Intuit's requestid: derive it from this one logical write and reuse it only to retry it, because QuickBooks answers a repeated key with the first request's answer instead of writing again, and a key is unique across every request to the company, so a different write, the reverse of an earlier one included, needs its own. At most 36 characters, Intuit's limit inside a batch.

min length 1max length 36

Input schema

schema

{
  "type": "object",
  "properties": {
    "entity": {
      "type": "string",
      "enum": [
        "Customer",
        "Vendor",
        "Account",
        "Department",
        "Class",
        "Item",
        "Invoice",
        "CreditMemo",
        "Payment",
        "JournalEntry",
        "Deposit",
        "Bill"
      ],
      "description": "The QuickBooks entity, by the name Intuit's API gives it."
    },
    "record": {
      "type": "object",
      "properties": {
        "Id": {
          "not": {}
        },
        "SyncToken": {
          "not": {}
        }
      },
      "additionalProperties": {},
      "description": "The new record as Intuit's API takes it, without an Id or a SyncToken; a Payment applies itself to invoices through Line[].LinkedTxn."
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36,
      "description": "The write's key, sent as Intuit's requestid: derive it from this one logical write and reuse it only to retry it, because QuickBooks answers a repeated key with the first request's answer instead of writing again, and a key is unique across every request to the company, so a different write, the reverse of an earlier one included, needs its own. At most 36 characters, Intuit's limit inside a batch."
    }
  },
  "required": [
    "entity",
    "record",
    "requestId"
  ]
}