Can HumDay connect to TheTVDB?

Yes. HumDay reads TheTVDB's own published API description and derives the operations from it, so there is no hand-built connector to wait for. 31 operations are documented.

Do I need to write code to automate TheTVDB?

No. You describe the outcome you want in plain words. HumDay agrees a contract with you, writes the program, and shows you a test run before anything touches your TheTVDB account.

What can HumDay do in TheTVDB?

5 of the 31 documented operations change something in TheTVDB, and 26 read from it. HumDay only ever uses the specific operations your approved contract needs.

Is my TheTVDB account safe?

Your credentials are stored encrypted and are never shown in chat, code, or logs. Every run is limited to the operations you explicitly approved, and anything that writes to TheTVDB is held behind that approval.

Automate TheTVDB

HumDay reads TheTVDB’s own published API description and derives 31 operations from it. Describe the outcome you want in plain words — you get a program that is written, proven on real data, and run for you.

Automate TheTVDB

What TheTVDB is

API v3 targets v2 functionality with a few minor additions. The API is accessible via https://api.thetvdb.com and provides the following REST endpoints in JSON format. How to use this API documentation ---------------- You may browse the API routes without authentication, but if you wish to send requests to the API and see response data, then you must authenticate. 1. Obtain a JWT token by `POST`i

What HumDay can do in TheTVDB

5 documented operations change something in TheTVDB.

PUTAdds the supplied series ID to the user’s favorite’s list and returns the updated list./user/favorites/{id}
DELETEDeletes the given series ID from the user’s favorite’s list and returns the updated list./user/favorites/{id}
DELETEThis route deletes a given rating of a given type./user/ratings/{itemType}/{itemId}
POSTReturns a session token to be included in the rest of the requests./login
PUTThis route updates a given rating of a given type./user/ratings/{itemType}/{itemId}/{itemRating}

What HumDay can read from TheTVDB

These are the operations a schedule or a trigger can watch.

GETReturns a list of query params for use in the /user/ratings/query route./user/ratings/query/params
GETReturns an array of ratings for a given user that match the query./user/ratings/query
GETReturns basic information about the currently authenticated user./user
GETReturns an array of ratings for the given user./user/ratings
GETAllows the user to search for a series based on the following parameters./search/series
GETReturns an array of favorite series for a given user, will be a blank array if no favorites exist./user/favorites
GETReturns an array of parameters to query by in the /search/series route./search/series/params
GETRefreshes your current, valid JWT token and returns a new token./refresh_token
GETReturns a series records, filtered by the supplied comma-separated list of keys./series/{id}/filter
GETReturns an array of series that have changed in a maximum of one week blocks since the provided fromTime./updated/query
GETThis route allows the user to query against episodes for the given series./series/{id}/episodes/query
GETReturns a movies records that contains all information known about a particular movies id./movies/{id}
GETReturns a series records that contains all information known about a particular series id./series/{id}
GETReturns an array of valid query keys for the /updated/query/params route./updated/query/params
GETAll available languages./languages
GETReturns all movies ids updated since a given timestamp./movieupdates
GETQuery images for the given series ID./series/{id}/images/query
GETReturns the list of keys available for the /series/{id}/filter route/series/{id}/filter/params
GETReturns the full information for a given episode id./episodes/{id}
GETInformation about a particular language, given the language ID./languages/{id}
GETReturns the allowed query keys for the /series/{id}/images/query route./series/{id}/images/query/params
GETReturns the allowed query keys for the /series/{id}/episodes/query route/series/{id}/episodes/query/params
GETReturns actors for the given series id/series/{id}/actors
GETReturns a summary of the images for a particular series/series/{id}/images
GETAll episodes for a given series./series/{id}/episodes
GETReturns a summary of the episodes and seasons available for the series./series/{id}/episodes/summary

How automating TheTVDB works

Describe the outcome. Say what you want to happen, in your own words. No node graphs, no field mapping.
Approve the contract. HumDay writes down exactly what it will do, what it will touch, and what it will never do. You approve it before anything is built.
See it proven. The program runs and shows you the result before it is allowed near your live TheTVDB account.
Grant access, then go live. You approve the specific TheTVDB operations it may use — and only those.

Popular TheTVDB integrations

Connect TheTVDB to the tools people pair it with most.