--- title: "User - User Status Changed" method: POST path: "user_status_changed" tags: ["Webhooks", "Users"] --- # User - User Status Changed `POST user_status_changed` (webhook) The status of a `User` changed. ## Headers - `X-Soldo-Fingerprint` string, required — [Webhook authentication](ref:webhook-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this webhook. - `X-Soldo-Fingerprint-Order` string, required — [Webhook authentication](ref:webhook-authentication): The order of the values used to calculate the fingerprint. - `X-Soldo-Fingerprint-Signature` string, required — [Webhook authentication](ref:webhook-authentication): Signature of the `X-Soldo-Fingerprint`. It must be verified using the [Soldo public key](ref:soldo-public-key). ## Payload - UserStatusChangedEvent - `event_uuid` string — The webhook unique ID. - `event_type` 'BusinessTrip' | 'Card' | 'Contact' | 'ExpenseReview' | 'Group' | 'OnlineAds' | 'Order' | 'Purchase' | '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' | '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' | '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' - `company_account_id` string — The company account ID. - `data` User - `id` string — The `User` ID. - `name` string — The name of the `User` (sortable: yes). - `surname` string — The surname of the `User` (sortable: yes). - `middlename` string — The middlename of the `User` (sortable: no). - `dob` string — The Date of birth of the `User`. - `job_title` string — The job title of the `User` (sortable: yes). - `department` string — The department of the `User` (sortable: no). - `email` string — The email address of the `User` (sortable: no). - `mobile` string — The mobile number of the `User` including the country code (sortable: no). - `mobile_prefix` string — The mobile number country code (sortable: no). - `custom_reference_id` string — The reference of the employee in an external system (sortable: yes). - `status` 'ACTIVE' | 'INACTIVE' | 'BLOCKED' | 'SUSPENDED' | 'PENDING' | 'ARCHIVED' - `visible` boolean — It determines whether the `User` is visible in the web console (sortable: yes). - `mobile_access` boolean — It determines whether the `User` has mobile access (sortable: no). - `web_access` boolean — It determines whether the `User` has web access (sortable: no). - `groups` string[] — The list of `Groups` ID the `User` is member of (sortable: no). - `shipping_address` Address - `id` string — The `Address` ID. - `recipient` string — The recipient of the `Address` - `name` string — The actual name of the `Address`. - `line1` string — The `Address` street. - `line2` string — An optional other street. - `country` string — The country of the `Address`. - `county` string — The county of the `Address`. - `city` string — The city of the `Address`. - `post_code` string — The postal code of the `Address`. - `delivery_phone_number` string — Delivery phone number - `default_shipping` boolean — True if the `Address` is the default shipping address. - `type` string — The type of the `Address`. - `category` 'USER' | 'COMPANY' - `user_id` string — The `User` ID, only if category of the `Address` is `USER`. - `creation_time` string — The date and time when the `Address` was created. - `last_update` string — The date and time when the `Address` was last updated. - `reports_to` string — The ID of the `User` it reports to. - `roles` UserRole[] — The list of `UserRole` of the `User`. - `id` string — The ID of the `UserRole`. - `name` string — The name of the `UserRole`. - `description` string — The description of the `UserRole`. - `scope` string — The scope of the `UserRole`. - `contact_id` string — The ID of the `Contact` assigned to the `User`. This information can be updated from the [Add Contact](ref:contact-add) and [Update Contact](ref:contact-update) endpoints. - `creation_time` string — The date and time when the `User` was created (sortable: yes). - `last_update` string — The date and time when the `User` was last updated (sortable: yes). - `work_status` 'AVAILABLE' | 'OUT_OF_OFFICE' - `subscription_id` string — The webhook subscription ID used to route this event. ## Acknowledgement `200` Success. --- [API](https://skmtc.net/soldo/apis/soldo-business-api-v2-0.md) · [All operations](https://skmtc.net/soldo/apis/soldo-business-api-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/soldo/soldo-business-api-v2-0/versions/7be21448a2b3/schema)