Create a Vehicle Card with Default Values
Learn how to create a vehicle card in the Fleet Management Services API.
Step 1: Fetch your Bearer Token
Use the WEX-provided client_id and client_secret to request for your bearer token.
curl --location --request POST 'https://wmd.xc.wexonline.com/oauth-service/uaa/oauth/token' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'Accept-Encoding: gzip,deflate,br' \--data 'grant_type=client_credentials&client_secret=1234&client_id=some-client-id'Step 2: Find your account
-
Fetch the list of accounts.
-
Choose the account you want to use for the new card.
curl --request GET \'https://wmd.xc.wexonline.com/fleet-service/v3/accounts?page=0&size=25&sort=accountName.keyword' \--header 'Accept-Encoding: gzip,deflate,br' \--header 'Authorization: Bearer' \--header 'Content-Length: 0'Step 3: Find your card profile
-
Fetch the list of card profiles.
-
Choose the card profile you want to use for the new card.
curl --location --request GET 'https://wmd.xc.wexonline.com/fleet-service/v3/accounts/1-A1BAJ2/card-profiles?page=0&size=25' \--header 'Accept-Encoding: gzip,deflate,br' \--header 'Authorization: Bearer' \--header 'Content-Length: 0'Step 4: Create the card
To successfully create the card, you’ll need the following:
-
The Account ID (fetched in Step 2).
-
The Card Profile ID (fetched in Step 3).
-
To have the physical card created and mailed, set
produce_cardto true. -
The
usage_typemust be set to “Asset”. -
Vehicle Information (Recommended): To attach a specific vehicle to this card, provide the vehicle details as shown in the code example.
- If you omit vehicle information: A new vehicle will be created and attached automatically; you can edit its details later.
Note on Shipping: Since no address is provided during card creation, WEX will ship the card to the default card shipping address configured on the account.
curl --location --request POST 'https://wmd.xc.wexonline.com/fleet-service/v3/v3/cards' \--header 'Accept-Encoding: gzip,deflate,br' \--header 'userId: 12345' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer' \--data '{ "account_id" : "1-A1BAJ2", "card_profile_id" : "1-KH2P1X", "produce_card" : true, "usage_type" : "Asset", "vehicle" : { "license_plate" : { "license_plate_number" : "abc123", "license_plate_state" : "AB", "license_plate_country" : "CA" }, "detail" : { "make" : "ford", "model" : "f150", "vin" : "18218237393038727278", "year" : "2020", "start_odometer" : 0 }, "company_vehicle_id" : "1234", "vehicle_description" : "truck", "distance_per_unit" : "10", "uom" : "Gallon", "tank_capacity" : "35" }}'}'
On this page
- Create a Vehicle Card with Default Values