Take action on your user's Motive Card

Log in to see full request history

Purpose: Use this endpoint to take one of the following actions on the Motive Card of your user:

Actions

  • Freeze: Put a temporary freeze on the Motive Card.
  • Unfreeze: Unfreeze a Motive Card that is already frozen.
  • Deactivate: Deactivate a Motive Card.

📘

NOTE

Deactivating a card is a permanent action.

You must also input reason_code and custom_reason, in the request body only when you are deactivating the Motive Card.


Body Params
string
required

Denote the action that you are taking on this particular Motive Card. Allowed values are:

  • freeze: Freeze your Motive Card temporarily.
  • unfreeze: Unfreeze you card from its existing freeze status.
  • deactivate: Deactivate your existing Motive Card.
string

reason_code is only applicable when you are deactivating a card. Allowed values are as follows:

  • 10: Specify this reason code if your card is lost.
  • 23: Specify this reason code if your card is stolen.
  • 15: Specify this reason code if the user is no longer at your company.
  • 31: Specify this reason code if the card is damaged.

string

Specify a custom reason for deactivating the card, if you do not find any of the above reasons suitable for your case. NOTE: Use only for deactivating a card. This field has a limit of 255 characters.

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json