Auth headers change

[TimMcCauley]

As part of our ongoing efforts to better protect your Etsy OpenAPI application, we will require all API requests to include a shared secret starting on January 18, 2026.

To ensure uninterrupted access to the OpenAPI after this date, please update your x-api-key header to include your shared secret. The new header format is x-api-key: keystring:secret, instead of the previous x-api-key: keystring.

You can find your shared secret on the Your Apps page: https://www.etsy.com/developers/your-apps

[TimMcCauley]

Greetings @anitabyte @d-winch - would it be possible to merge these branches for us? I am happy to help you maintain this library if it helps. From what I can tell, it is still used quite a bit. Many greetings, Tim

[harispoljo]

Is this getting merged?

[d-winch]

@TimMcCauley Thanks for the work on this.

To clarify: I do not have write access to this repository, so I am unable to merge this PR myself. I previously contributed several endpoints our store needed, but I believe @anitabyte is the sole maintainer.

Since the Etsy deadline is in 2 days (Jan 18), this is critical. I am also happy to step up as a co-maintainer alongside Tim to help keep this library alive.

[phillipdavidstearns]

Would it be possible to update the release on pypi to include these changes?

[ramibch]

For those using uv, you can add the dependency with the Tim fix by running:

uv add git+https://github.com/TimMcCauley/etsyv3.git@auth-headers-change

Many thanks @TimMcCauley, I am now able to upload my listings to Etsy from by backend!

[Themis3000]

It looks like this requirement has just been moved into effect and this package is no longer functional as of today. I was about to open a nearly identical pull request after getting my requests 401'd today. I read the etsy docs and made almost the same exact fix.

Are any of the maintainers considering publishing/maintaining a fork to pypy with the fix implemented?

[TimMcCauley]

I have created a pypi project with my fork - would anyone like write permissions?

https://github.com/TimMcCauley/etsyv3
https://pypi.org/project/etsyv3-api/0.1/

[Themis3000]

I have created a pypi project with my fork - would anyone like write permissions?

https://github.com/TimMcCauley/etsyv3 https://pypi.org/project/etsyv3-api/0.1/

Thank you, I appreciate it you publishing that. I'll accept write permissions on the pypi/git repo if you're willing/trusting of me. I'll only use the perms if you become MIA for a bit.

[TimMcCauley]

Cool, thanks! I invited you @Themis3000 !