TikTok error 40103: refresh token expired
TikTok error 40103 means the refresh token has expired, so it can no longer renew the account's access token. An Accounts API refresh token is valid for one year. The fix TikTok gives is a new authorization: the account owner goes through the app's authorization flow again, which returns a new access token and a new refresh token to store in place of the old pair.
easyCoexistence stores the refresh token and its expiry from every TikTok renewal and renews the 24-hour access token on its own, for Claude, ChatGPT or your own code.
TikTok's return code for an expired refresh token; the fix is for the user to authorize the app again.
How long an Accounts API refresh token stays valid.
Seconds in refresh_token_expires_in, exactly one year, in TikTok's example of newly issued tokens.
How long the authorization code from a new authorization stays valid, for a single use.
What does error 40103 mean?
The refresh token sent to renew the access token is past its expiry. TikTok's return code appendix lists 40103 as an expired refresh token. Its fix is to use a valid refresh token, and to get one, to ask the user to authorize the app again through the user authorization workflow. Until that happens the access token cannot be renewed, and calls stop working when the current one reaches the end of its day.
How long does a refresh token last?
One year. The response from /tt_user/oauth2/token/ includes refresh_token_expires_in, the seconds left before the refresh token expires: 31,536,000 in TikTok's example, exactly a year. Renewal responses carry the same field, and TikTok's renewal example shows 28,484,364 seconds, less than a year, so read the figure from each response rather than assuming every renewal starts a new year.
How do you fix it?
Ask the account owner to authorize the app again. Share the TikTok account holder authorization URL; once they approve, TikTok redirects to the app's redirect URL with a new auth_code, valid for 10 minutes and usable once. Exchange it at /tt_user/oauth2/token/ for a new access token and refresh token, and replace the stored pair. If the owner approved the same permissions before, TikTok skips the review page by default and sends them straight back.
How does 40103 differ from 40107 and 40131?
The appendix has three codes for a renewal that fails, and they point to different checks:
- 40103: the refresh token has expired. Only a new authorization replaces it.
- 40107: the refresh token is invalid or incorrect, for example one sent to renew a Marketing API token, which never expires.
- 40131: an authentication error at /
tt_user/oauth2/token/ or /tt_user/oauth2/refresh_token/, from a wrong app ID or secret, an expired authorization code, or an invalid or expired refresh token.
Common mistakes
- Waiting for 40103 to plan the next authorization. refresh_token_expires_in gives the date in advance, so the owner can be asked before renewal stops.
- Assuming each renewal restarts the year. TikTok's renewal example returns less than a year in refresh_token_expires_in, so read the value from every response.
- Discarding the refresh token that a renewal returns. TikTok's reference says to retain it for the next renewal.
If TikTok refuses a renewal, the tool returns TikTok's code and message, and connecting the account again from the dashboard issues a new pair of tokens. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Do Content Posting API refresh tokens also last a year?
No. TikTok for Developers' refresh tokens, used by the Content Posting API, last 180 days; the one-year lifetime belongs to API for Business refresh tokens, whose remaining seconds appear in refresh_token_expires_in.
Can an expired TikTok refresh token be renewed?
No. TikTok's fix for 40103 is a new authorization by the account owner, which issues a new access token and a new refresh token.
Does the owner see TikTok's permission page again?
Not by default. If they approved the same permissions before, TikTok skips the review page and redirects to the app with a new authorization code.
What happens to calls after the refresh token expires?
They keep working until the current access token reaches the end of its day. After that they fail with 40102, since the token can no longer be renewed.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on