---
title: "Invite Marketplace Worker"
method: POST
path: "/marketplace/invite"
tags: ["marketplace"]
---

# Invite Marketplace Worker

`POST /marketplace/invite`

## Request

- Base URL: `https://app.tascan.io/api/v1`
- URL: `https://app.tascan.io/api/v1/marketplace/invite`
- Auth: HTTP bearer

Invite a marketplace worker to a task list — the consented intro. TaScan texts the worker from its own number ("<Your org> wants you for <list>. Reply YES to share your contact and get the list, or NO to pass."). On YES the worker appears in your org with their name + phone, receives the list link, and you get a text + a thread message. On NO or silence (7 days) you never learn who they were. Use the worker_id from tascan_search_marketplace.

## Request body

- object
  - `worker_id` string, required: worker_id from a marketplace card
  - `list_id` string, required: Task list you want them on
  - `message` string: Optional short intro prepended to the text (max 240 chars)

## Response `200`

Success. JSON body: { data: ... } or an error object { error, message }.

## Other responses

- `4XX`: Client error (validation, auth, scope, rate limit).

---

[API](https://skmtc.dev/tascan/apis/tascan-api.md) · [All operations](https://skmtc.dev/tascan/apis/tascan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tascan/apis/tascan-api/revisions/56fcd2861498?raw)