Media Servers

Emby billing: connect your Emby server and sell access

Make an API key on your Emby server, add it to your portal and sell plans. Customer accounts are created and disabled for you.

3 min read
Published November 10, 2026
Last checked November 10, 2026
emby
media-server
integration
billing

Emby servers connect with an API key. Once connected, a customer who pays gets their own account on your Emby server with the limits of their plan, and their login by email. When they stop paying, the account is disabled. You don't run any script of your own.

1Step 1 of 3Make an API key on your Emby server

Sign in to your Emby dashboard as an administrator. Go to Advanced → API Keys, click New Api Key and give it a description.

Copy the key. These menus are part of Emby, not of your portal.

2Step 2 of 3Add the server

Go to Panels → Media servers → All media servers. Under Add New Service, click the Emby card and fill in:

  • Display Name: a name for the server. The first product you sell from it is named after it; you can rename the product later.
  • Server URL: the address of your Emby server, usually on port 8096. Enter the server's own address, without /emby or /web at the end.
  • API Key: the key from step 1.

Click Add Server. Your server's page opens.

3Step 3 of 3Create and sell plans

Open the Plans tab, click Create plan, set the streams and prices and click Save Template. Then click Sell as product on the plan and Create product. The full walkthrough is in the guide on media server plans, linked below.

What happens automatically

  • Purchase: the customer picks a username on your product page and can choose their own password there; if they leave it blank, we make one. (To always make the password yourself, untick Customers choose their own password at checkout in the Customer login card on the product's edit page.) We create their account on your server, apply the plan's limits and email them their login and your server's address.
  • Libraries: a new account gets the libraries ticked on its plan. With nothing ticked, the plan gets every library on your server. If the plan has Optional libraries, a customer who leaves one out gets the plan's libraries without it. Existing customer accounts keep the libraries they already have: changing the ticks later only affects accounts created after the change.
  • Streams: the plan's stream limit is saved on the customer's Emby account as that user's simultaneous stream limit, so your server itself enforces it.
  • Plan changed later: on the Plans tab, click Re-sync limits to apply the new limits to customers with an active subscription. Accounts you made yourself are not touched.
  • Renewal: the account stays on. If it had been switched off, renewing switches it on again.
  • Not paid: after your store's grace period (normally 7 days after the end date), the account is disabled, not deleted.
  • Cancelled: the customer keeps access until the end date, then the account is disabled.
  • Free trial ended: the trial account is removed straight away. Trials get no grace period.

Good to know

  • How your store signs in: the API key is sent to your server in Emby's own request header, never in the address.
  • Jellyfin is a separate service. It has its own card and its own guide: Jellyfin billing.

Ready to try it yourself?

Spin up your own IPTVbp store and connect a panel. It's free until you have 25 paying customers, no card needed.

Start free trial