# Create a commission from another tool

In order to make easy integrations with external websites, FFXIV Teamcraft has an "endpoint" in order to create a commission easily.

This is a page that you can simply redirect your users to, example:

`<a href="https://ffxivteamcraft.com/commission/import/U3VzYW5vIE1pbmlhdHVyZXwwfENSQUZUSU5HLEdBVEhFUklORyxIVU5USU5HfDUwNTcsLDk5OzE3OTYyLCwxfGFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFh">Create a Teamcraft commission.</a>`

The link is pretty simple, `https://ffxivteamcraft.com/commission/import/<base64(importString)>`.

`importString` is the key to the import of item(s) here, let's see what's expected:

First things first, the example above uses this import string: `Susano Miniature|0|CRAFTING,GATHERING,HUNTING|5057,,99;17962,,1|aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa`

The format being (separated by a `|`):

* Commission name.
* Price paid for it.
* Tags, separated by commas (list of availabletags [here on github](https://github.com/ffxiv-teamcraft/ffxiv-teamcraft/blob/staging/apps/client/src/app/modules/commission-board/model/commission-tag.ts)).
* Items, composed of (and separated by semicolons):
  * ID of the item.
  * Recipe ID for this item (optional, just leave it blank if you don't want to specify a recipe id).
  * Quantity to add to the commission.
* Description for this commission, can be blank (but leave the last `|`).

The string used as example above creates a commission with:

* **Name "Susano Miniature".**
* **Price paid of 0, meaning that the price is to be discussed.**
* **Tags: CRAFTING, GATHERING and HUNTING.**
* **Items:**
  * **Iron Ingot (ID 5057) x99 with no specified recipe id.**
  * **Susano Miniature (17962) x1 with no specified recipe id.**
* **Description: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa".**

#### Some rules you might want to know:

* The recipe id isn't mandatory, if you don't give it, the UI will ask the user to pick one or will pick the only one if there's only one recipe available.&#x20;
* Items that you add can be non-craftable items too, Teamcraft will handle them like a charm.
* There is no limit with the amount of items you will import, except url length.
* Items that cannot be traded will be removed from the commission when it's created, better remove them yourself before the call to avoid hitting maximum url length (2000 chars).

If you have any questions, DM Miu#1568 on discord, I will be happy to reply and help you integrate Teamcraft in your project.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.ffxivteamcraft.com/dev-stuff/crate-a-commission-from-another-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.