# Import a list from another tool

In order to make easy integrations with external websites, FFXIV Teamcraft has an "endpoint" in order to create lists or add item(s) to any list.

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

`<a href="https://ffxivteamcraft.com/import/MjA1NDUsbnVsbCwzOzE3OTYyLDMyMzA4LDE7MjAyNDcsbnVsbCwx">Import on FFXIV teamcraft</a>`

The link is pretty simple, `https://ffxivteamcraft.com/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: `20545,null,3;17962,32308,1;20247,null,1`

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

* item id
* recipe id, or `"null"`
* quantity

Then repeat and use `;` as separator for each item you want to import.

**Do not add a final `;`, this won't work.**

The string used as example above imports the items:

* **20545, without specifying a recipe, and it imports 3 of it.**
* **17962, with recipe id 32308, and it imports one.**
* **20247, without specifying a recipe, and it imports one.**

#### The callback feature

In case you want to know what has been created or updated from your link, you can provide a callback url to the link, example:

`https://ffxivteamcraft.com/import/MjA1NDUsbnVsbCwzOzE3OTYyLDMyMzA4LDE7MjAyNDcsbnVsbCwx?callback=https://example.com/list-created`

Teamcraft will send the created list link using a `POST` request once the list has been created or the item has been added to an existing list.

The payload sent by the request is: `{ url: string }`. Example: `{ url: https://ffxivteamcraft.com/list/superrandomid }`

#### 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.

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/import-a-list-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.