Add an entry to your AniList list
add_list_entryAdd an anime or manga to your AniList list by media ID, including score, progress, status, notes, and dates. Use it to create a new entry or update an existing one without losing unset fields.
Instructions
[Requires login] Add an anime/manga to the authenticated user's own AniList list. Use search_media first to resolve the title to its AniList media ID. Only set the fields you care about — everything else is left at AniList's defaults ONLY if this media isn't already on the list. AniList upserts by media ID: if an entry for it already exists (e.g. previously dropped, with its own score/notes/progress), calling this updates that entry in place instead — every field you don't set here keeps its previous value, not a default. Use get_user_list first to check for an existing entry if you need a guaranteed-fresh one. The response echoes what AniList actually stored, so check it rather than assuming the write landed verbatim. It includes customLists/advancedScores only when you set them — those are the fields AniList zeroes/replaces rather than merges, so they're worth reading back; otherwise the echo is trimmed, since a list sync is hundreds of writes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Free-text notes for this entry (per AniList's own schema, capped at 6000 characters). | |
| score | No | Score out of 10 (decimals allowed, e.g. 8.5), always on this scale regardless of the account's configured scoreFormat (set via update_user) — no conversion needed. | |
| repeat | No | Number of times rewatched/reread (per AniList's own schema, capped at 1000). | |
| status | No | List status. If omitted on a genuinely NEW entry, AniList defaults to CURRENT (with `startedAt` auto-set to today) — confirmed live; despite AniList's own site UI defaulting new entries to Planning, the API itself does not. If the media is already on the list, this default does NOT apply — omitting `status` on an update-in-place leaves the entry's existing status untouched. | |
| mediaId | Yes | AniList anime/manga ID to add (from search_media). | |
| private | No | Hide this entry from your public list. | |
| priority | No | List priority (higher = more important; per AniList's own schema, capped at 255). | |
| progress | No | Episodes watched / chapters read. | |
| startedAt | No | Date you started. | |
| completedAt | No | Date you completed. | |
| customLists | No | Names of custom lists to file this entry under — REPLACES this entry's full set of enabled lists, not merged: naming only a subset silently turns OFF every other list this entry was previously filed under (confirmed live), it doesn't leave them alone. Include every list name you want this entry to stay tagged with, not just the one you're adding. Also, the list must already exist on the account (update_user's `animeListOptions`/`mangaListOptions` `customLists`) — naming one that doesn't exist yet is silently a no-op, not an error. | |
| advancedScores | No | Per-category scores, 0-10 scale (e.g. {Story: 8, Characters: 9}) — errors if advanced scoring isn't enabled for this media's type, or if a key doesn't match the account's configured category list for it (anime and manga have SEPARATELY configured lists). Any of that list's categories you omit here is set to 0, not left unchanged — include every category if you don't want the others zeroed. Stored positionally, not by name: matched against the account's category order (update_user's `advancedScoring`) at READ time, not write time — if that order is later renamed/reordered, a score you write for 'Story' today can silently be read back as 'Characters' tomorrow, with no error. | |
| progressVolumes | No | Volumes read (manga only). | |
| hiddenFromStatusLists | No | Hide this entry from the public status-grouped list views (e.g. 'Watching') while still counting it in statistics — distinct from `private`, which hides the entry entirely. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entry | Yes |