Matchai Docs

Add a listing to a projectComing soon

Adds a listing you can manage to the project.

Coming soon. This is documented ahead of launch so you can plan your integration; it is not available yet.
PUT
/projects/{project_id}/listings/{listing_id}

Coming soon. Adds a listing you can manage to the project.

Scopes: projects:write

Pricing: Included with the connection.

Authorization

headerAuthorizationBearer <matchai_<base62>>

A personal API key, sent as Authorization: Bearer matchai_…. Create keys in Matchai under Settings → Connectors → Advanced (for developers). A key starts with matchai_ followed by letters and digits, carries the scopes chosen when it was created, and can be revoked at any time. Keys reach only the account that created them: to serve other professionals, use Connect with Matchai.

Scope: projects:write

Path Parameters

project_id*string

Project id.

Length1 <= length <= 64
listing_id*string

Listing id, or its slug.

Length1 <= length <= 200

Response Body

Listings on the project.

application/json
  1. response
data*array<>

Listings on the project.

Example Request
curl -X PUT 'https://api.matchai.co/v1/projects/string/listings/string'
Example Response
{  "data": [    {      "id": "string",      "slug": "string",      "url": "http://example.com",      "title": "string",      "status": "draft",      "availability": "available",      "price": {        "amount": 1,        "currency": "string"      },      "city": "string",      "neighbourhood": "string",      "bedrooms": 0,      "bathrooms": 0,      "cover_image_url": "http://example.com"    }  ]}