Put your stock on MotorLoop from your own system

Type it once, not twice

If your stock already lives somewhere — a dealer management system, a spreadsheet, your own website — that system is the source of truth. Re-typing each car into a second web form is where the errors come from: the price that was updated in one place and not the other, the car that sold on Tuesday and was still advertised on Friday.

New here? MotorLoop is a place to buy, sell & show cars, and listing is free. Create an account to get started, or read how we compare to other sites.

Your first call, in about five minutes

1. 01

   Create an account

   Free, and the same account you would use to list a car by hand.

2. 02

   Mint a token

   Profile → API tokens → Create token. Tick “Create and update your listings” if you intend to write. The secret is shown once.

3. 03

   Check it is accepted here

   See the banner at the top of this page. If REST is off for this storefront, an administrator turns it on first.

4. 04

   Read the field schema

   Call /api/vehicles/attributes before you write anything. It tells you the field names, types and allowed values for this storefront.

Then read five listings — no token needed

Searching is open to anyone, so this runs before you have signed up for anything.

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles?pageSize=5'

https://api.motorloop.com.au/motorloop

Five things that will bite you

Each of these returns a success code while doing something other than what you meant. They are worth two minutes now.

Try it without writing any code

The API publishes an interactive console and a machine-readable OpenAPI document. The console sends real requests, so you can paste a token in and watch a call succeed before you build anything. The document imports straight into Postman, Insomnia or a client generator.

The document describes the member surface only — the endpoints on this page, and none of the administrative ones. Because you fetch it under a storefront, it comes back already pointed at https://api.motorloop.com.au/motorloop: paths resolve as-is, with nothing to configure.

Endpoint reference

Everything a member account can reach. Anything marked NO TOKEN works signed out.

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles/by-slug/2019-toyota-corolla-ml-abc-123'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles/mine' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles/attributes'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles/facets'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/vehicles/makes'

curl -X POST 'https://api.motorloop.com.au/motorloop/api/vehicles' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "make": "Toyota",
  "model": "Corolla",
  "odometerKm": 84200,
  "price": 21990,
  "currency": "AUD",
  "description": "One owner, full service history, new tyres.",
  "extras": {
    "ModelYearMY": [
      "2019"
    ],
    "State": [
      "VIC"
    ],
    "BodyType": [
      "Hatch"
    ],
    "Transmission": [
      "Automatic"
    ],
    "FuelType": [
      "Petrol"
    ],
    "Colour": [
      "White"
    ],
    "StockNumber": [
      "DLR-1042"
    ],
    "Features": [
      "Bluetooth",
      "Reversing Camera",
      "Apple CarPlay"
    ]
  },
  "termsVersion": "2026-08-03"
}'

curl -X PUT 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "make": "Toyota",
  "model": "Corolla",
  "odometerKm": 84200,
  "price": 20990,
  "currency": "AUD",
  "description": "One owner, full service history, new tyres.",
  "extras": {
    "ModelYearMY": [
      "2019"
    ],
    "State": [
      "VIC"
    ],
    "BodyType": [
      "Hatch"
    ],
    "Transmission": [
      "Automatic"
    ],
    "FuelType": [
      "Petrol"
    ],
    "Colour": [
      "White"
    ],
    "StockNumber": [
      "DLR-1042"
    ],
    "Features": [
      "Bluetooth",
      "Reversing Camera",
      "Apple CarPlay"
    ]
  }
}'

curl -X POST 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/status' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "status": "Active"
}'

curl -X POST 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/price' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "price": 20990,
  "currency": "AUD"
}'

curl -X POST 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/flags' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "socialSharing": true,
  "listingType": "SaleOrSwap"
}'

curl -X DELETE 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN'

curl -X POST 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/images' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN'

curl -X PUT 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/images/order' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "imageIds": [
    "00000000-0000-0000-0000-000000000001",
    "00000000-0000-0000-0000-000000000002"
  ]
}'

curl -X PUT 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/images/00000000-0000-0000-0000-000000000000/label' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "tagId": null
}'

curl -X PUT 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/images/00000000-0000-0000-0000-000000000000' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN'

curl -X DELETE 'https://api.motorloop.com.au/motorloop/api/vehicles/00000000-0000-0000-0000-000000000000/images/00000000-0000-0000-0000-000000000000' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/auth/me' \
  -H 'Authorization: Bearer mlp_YOUR_TOKEN'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/tenant-info'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/tags'

curl -X GET 'https://api.motorloop.com.au/motorloop/api/places'

Statuses you can set

Moving a listing into or out of the moderation queue is an administrator action, so those states are not settable through the API.

This storefront’s vehicle fields

MotorLoop accepts 79 vehicle fields beyond make, model and odometer. They are configurable, so treat this list as a snapshot and read /api/vehicles/attributes at run time rather than hard-coding it.

Columns your file needs

Templates for this storefront

Generated from the schema above, not a generic sample — the columns are the ones this storefront actually accepts.

Doing it in bulk

Being straight with you about where this stands: there is no REST endpoint that takes a whole file today. What exists is one request per vehicle, and a batch tool on the MCP side. The CSV template above is a format for your own importer to read — there is nowhere to upload it.

REST or MCP?

Two ways into the same marketplace, and the same token works with both. Broadly: write code against REST, point an assistant at MCP.

Connect an AI assistant instead →

Common questions

Do I need to be a dealer to use the API?

No. Any account can create a token. The API gives a private seller with one car exactly the same endpoints a dealer with two hundred gets — there is no separate tier and nothing to apply for.

What does it cost?

Listing on MotorLoop is free, and using the API to do it is free too. There is no per-call charge and no separate developer plan.

My token works with an AI assistant but the API returns 401.

Reaching the REST endpoints is a separate per-storefront setting, and it is off until a storefront administrator turns it on. The refusal deliberately looks the same as an invalid token, so check the banner at the top of this page for this storefront’s answer before you go looking for a bug in your code.

Why did my listing lose its details after an update?

PUT replaces the whole listing: the attributes you send become the complete set, and anything you leave out is cleared. For a routine change use the price, status or flags endpoints, which touch only what they name.

Where do I put the year?

In the attributes bag, under whatever the storefront calls its model-year field — ModelYearMY on the standard catalogue. There is no top-level year field, and one sent at the top level is ignored rather than rejected, so the listing saves without it.

Can I upload photos from URLs?

Not through REST, which takes uploaded files. The MCP bulk import does fetch photos from URLs you host, which is usually the easier route when your images are already on a web server.

Will my listings be published automatically?

No. Everything created through the API starts as a draft and stays private until you call the status endpoint. That is deliberate: it gives you a chance to check an import before buyers see it.

What happens if I run the same import twice?

Through the MCP bulk import, rows carrying a stock number you have already used are reported as skipped rather than duplicated. Through REST, each request creates a listing, so your own script needs to track what it has already sent.