Webhooks

Vehicles

Vehicle - Vehicle Update

A Vehicle has been updated.

postWebhookvehicle_update

Headers

X-Soldo-Fingerprintstring required

Webhook authentication: SHA-512 hash (lowercase hexadecimal) of the values listed in X-Soldo-Fingerprint-Order, concatenated in that order, followed by your fingerprint token.

Example:{{fingerprint}}

X-Soldo-Fingerprint-Orderstring required

Webhook authentication: The comma-separated list of the fields used to calculate the X-Soldo-Fingerprint, in the order they must be concatenated.

Example:id,numberPlate

X-Soldo-Fingerprint-Signaturestring required

Webhook authentication: Signature of the X-Soldo-Fingerprint, generated with the SHA512withRSA algorithm and encoded in Base64. It must be verified using the Soldo public key.

Example:{{fingerprint_signature}}

Payload

event_uuidstring

The webhook unique ID.

event_type'BusinessTrip' | 'Card' | 'Contact' | 'ExpenseReview' | 'Group' | 'OnlineAds' | 'Order' | 'Purchase' | 'Refueling' | 'Subscription' | 'Transaction' | 'TransactionAttachment' | 'Employee' | 'Vehicle' | 'Wallet'

event_name'business_trip_created' | 'business_trip_updated' | 'business_trip_deleted' | 'card_activated' | 'card_change_status' | 'card_creation' | 'card_destroyed' | 'card_lost' | 'card_replaced' | 'card_stolen' | 'card_label_updated' | 'card_assignee_updated' | 'add_resources_card' | 'add_resources_member' | 'add_resources_wallet' | 'create_group' | 'delete_group' | 'move_resources_card' | 'move_resources_member' | 'move_resources_wallet' | 'remove_resources_card' | 'remove_resources_member' | 'remove_resources_wallet' | 'update_group' | 'store_order_completed' | 'store_order_placed' | 'balanced_transfer' | 'billing' | 'card_authorization' | 'conversion' | 'customer_care_deposit' | 'customer_care_withdraw' | 'edit_tag' | 'inbound_payment' | 'inbound_payment_reversal' | 'internal_transfer' | 'inter_account_transfer' | 'inter_account_transfer_recurring_billing' | 'joule_feed' | 'load_failed' | 'load_money' | 'recurring_billing' | 'scheduled_transfer' | 'transaction_adjustment' | 'unload_money' | 'wiretransfer' | 'upload_completed' | 'attachment_delete' | 'new_user' | 'user_status_changed' | 'user_updated' | 'user_deleted' | 'wallet_created' | 'wallet_deleted' | 'vehicle_create' | 'vehicle_update' | 'vehicle_delete' | 'purchase_create' | 'purchase_update' | 'purchase_delete' | 'purchase_redeem_card' | 'created_expense_configuration' | 'disabled_expense_configuration' | 'enabled_expense_configuration' | 'updated_expense_configuration' | 'completed_transactions_import' | 'updated_transaction' | 'change_expense_type' | 'subscription_activated' | 'subscription_created' | 'subscription_updated' | 'subscription_deleted' | 'subscription_assignee_added' | 'subscription_assignee_removed' | 'online_ads_activated' | 'online_ads_created' | 'online_ads_updated' | 'online_ads_deleted' | 'online_ads_assignee_added' | 'online_ads_assignee_removed' | 'transaction_created' | 'transaction_modified' | 'transaction_deleted' | 'transaction_business_trip_linked' | 'transaction_business_trip_unlinked' | 'contact_created' | 'contact_updated' | 'contact_deleted' | 'refueling_created' | 'refueling_updated' | 'refueling_deleted'

company_account_idstring

The company account ID.

subscription_idstring

The webhook subscription ID used to route this event.

Example payload

{
  "event_uuid": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
  "company_account_id": "XMPL1234",
  "data": {
    "id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
    "number_plate": "AA000BB",
    "description": "Employee electric vehicle",
    "creation_time": "2017-06-01T12:48:40Z",
    "last_update_time": "2017-06-01T12:48:40Z",
    "card_ids": [
      "7bf79328-a7ae-4222-aa54-091ff7f429a7",
      "2d65bd5e-3fdf-4002-b166-bde7fb8863fa"
    ],
    "reimbursement_rate": 0.45,
    "mileage": 125000
  },
  "subscription_id": "2d65bd5e-3fdf-4002-b166-bde7fb8863fa"
}

Response

Success.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.