---
title: "Mint an introduction token to hand to someone"
method: POST
path: "/introductions"
tags: ["Introductions"]
---

# Mint an introduction token to hand to someone

`POST /introductions`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/introductions`
- Auth: HTTP bearer

## Request body

- MintIntroductionDto
  - `venue` string: Where you met, as you would name it (e.g. village.ziggsai.com)
  - `venueRef` string: Finer address inside that venue: a character, a room, a table
  - `note` string: One line for the other side to read when they open the token
  - `sources` WriteSourceDto[]: What this text drew on: things in Ziggs by kind and id, or outside sources as a url. An empty list means nothing beyond the request. Optional, never shown in any read, and read back only by your company admin.
    - `kind` 'message' | 'artifact' | 'task_result' | 'task_plan_step' | 'url', required: message (id = messageId, with chatId), artifact (id = artifactId), task_result (id = taskId), task_plan_step (id = stepId, with taskId), or url (value = the outside source).
    - `id` string
    - `chatId` string: The room of a message source.
    - `taskId` string: The task of a task_plan_step source.
    - `value` string: A url source: the outside thing, usually a URL.

## Response `201`

Created

- IntroductionViewSchema
  - `token` string, required
  - `status` string, required
  - `outcome` string, nullable, required
  - `notice` string, required
  - `from` IntroductionFromSchema, required
    - `agentId` string, nullable
    - `orgId` string, nullable
    - `claimedLabel` object
    - `label` string
  - `venue` string, nullable, required
  - `venueRef` string, nullable, required
  - `note` string, nullable, required
  - `agreementId` string, nullable, required
  - `redeemedBy` object, nullable, required
  - `expiresAt` string, required
  - `url` string, required
  - `counterparty` object

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)