Create Vehicle with UDFs
Learn how to create a vehicle with user defined fields (UDFs) 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
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
-
Find your account.
-
Fetch the list of accounts and pick the one that you want to use to create a vehicle with UDFs.
CURL
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: Create vehicle with UDFs
- Complete the necessary information using the
account_idthat was fetched in Step 2.
Note: vehicle_prompt_idis editable only for accounts enabled for customer-assigned prompt IDs. The accepted length for this ID (either 4 or 6 digits) is defined on the account record.
UDFs are defined by a specific position (from UDF1 to UDF20). You can add them in any order, allowing for any user-defined value, provided the value does not exceed 50 characters in length.
CURL
curl --location --request POST 'https://wmd.xc.wexonline.com/fleet-service/v3/vehicles' \--header 'accept-encoding: gzip,deflate,br' \--header 'content-type: application/json' \--header 'authorization: Bearer' \--data '{ "account_id": "1-29JJK", "asset_type": "ASSET", "company_vehicle_id": "Your vehicle id", "description": "Van", "vehicle_prompt_id": "123433", "license_plate": { "license_plate_number": "2838A", "license_plate_state": "AZ", "license_plate_country": "US" }, "detail": { "make": "Toyota", "model": "Prius", "vin": "12347463536738373", "year": "2020", "start_odometer": 0 }, "fuel": { "tank_capacity": 20, "unit_of_measure": "GALLONS", "mpg": 60 }, "user_defined_fields": [ { "field_name":"UDF1", "position": 0, "value": "Your Data 1" }, { "field_name": "UDF11", "position": 10, "value": "Your Data 11" }, { "field_name": "UDF14", "position": 13, "value": "Your Data 14" } ]}’Was this section helpful?
On this page
- Create Vehicle with UDFs