Connect BrickLink
Connect your BrickLink store with its four API credentials, so BrickInvoice can fetch your orders.
BrickLink uses OAuth 1.0a, so connecting takes four credentials: a consumer key and secret, and a token value and secret. You create them once on BrickLink and paste them into BrickInvoice.
Table of Contents
- Before you start
- Get your credentials on BrickLink
- Enter them in BrickInvoice
- Status
- Error messages
- Changing your credentials
- Instant order updates
- Removing the connection
- Next steps
Before you start
You need a BrickLink seller account. Set your country in your settings as well: BrickInvoice fetches your orders as soon as a store is connected and a country is set.
You will paste four values:
- Consumer key
- Consumer secret
- Token value
- Token secret
Get your credentials on BrickLink
- Log in to your BrickLink account.
- Open the BrickLink API registration page:
https://www.bricklink.com/v2/api/register_consumer.page - Enter
0.0.0.0as the IP address and0.0.0.0as the IP mask, and click Add. - BrickLink then shows your Consumer Key, Consumer Secret, Token Value and Token Secret.
The help card next to the form on the Stores page has the same steps, with a link to the registration page.
Enter them in BrickInvoice
- Go to Connections → Stores and find the BrickLink block (or open
/home/connections/stores#bricklink). - Paste the four values into Consumer key, Consumer secret, Token value and Token secret. The two secrets are hidden as you type.
- Click Test connection. BrickInvoice checks the credentials with BrickLink without saving anything. When they work, you see BrickLink accepted these credentials.
- Click Save connection. This button only works after a successful test.

The block now shows Connected to BrickLink with Your credentials are saved. BrickInvoice stores the credentials encrypted and starts fetching your orders, right away if your country is set.
Status
The badge next to the BrickLink heading, and the dot in the link at the top of the page, show one of three states:
- Connected: orders are fetched.
- Stopped: reconnect: BrickLink refused your credentials several times in a row, so BrickInvoice no longer contacts it. The block says BrickLink stopped: reconnect. Enter working credentials under Change connection to start again.
- Not connected: no credentials are saved.
Error messages
When the test or the save fails, the form tells you why:
- BrickLink did not accept these credentials. Check the consumer key, consumer secret, token value and token secret, and try again. Copy the four values again from BrickLink, without spaces at the start or end. If that does not help, check that the IP address and mask are both
0.0.0.0. - BrickLink could not be reached. Try again in a moment.
- We could not check these credentials with BrickLink. Try again in a moment.
- These keys belong to a different BrickLink store than the one your inventory sync keeps in step. Once you have started an inventory sync, BrickInvoice only accepts credentials of that same store. Connect the keys of that store: moving the sync to another store is not possible.
When a test or save fails, nothing is written. A connection that was already working stays as it is.
Changing your credentials
- In the BrickLink block, click Change connection.
- Paste the new credentials and click Test connection.
- Click Update connection to save them, or Cancel to keep the old ones.
The connection keeps running on the old credentials until the new ones are saved.
Instant order updates
This part of the block only shows while an inventory sync runs. Without it, BrickInvoice fetches new orders on its usual schedule. With it, BrickLink tells BrickInvoice about a new order within seconds.
Under Instant order updates you find your Callback URL:
- Click Generate URL if there is no URL yet, and confirm.
- Click Copy URL.
- Click Open your consumer keys on BrickLink and paste the URL as the Callback URL of your consumer key.
The line below the URL says Not set up yet until the first update arrives, and then Receiving updates with the time of the last one.
Generate new URL replaces the URL. The old one stops working right away, so paste the new one into BrickLink. If you save credentials with another consumer key while the sync runs, you also get a new URL, and the block asks you to paste it into BrickLink.
Removing the connection
Click Remove connection in the BrickLink block. The dialog Remove the BrickLink connection? lists what happens:
- Your stored BrickLink credentials are deleted, and orders from BrickLink are no longer fetched.
- If BrickLink is in a running inventory sync, BrickInvoice first fetches and books your last BrickLink orders, and changes not yet sent to BrickLink are cancelled. If that fetch fails, the connection stays and the dialog says why (The BrickLink connection was not removed), with Try again.
- If that leaves fewer than two stores, the dialog warns that your inventory sync stops. Your stock stays in BrickInvoice, nothing on BrickLink or Brick Owl is undone, and orders from then on cost no inventory fee.
Click Remove connection to go ahead, or Keep the connection. While the last orders are fetched you see Fetching your last orders from BrickLink. You can close the window: the connection is removed as soon as the orders are in.
Next steps
- Check that the badge says Connected.
- Wait for the first orders, or look at the last and next fetch on Connections → Schedules.
- Connect Brick Owl as well if you sell there: Connect Brick Owl.
- Connect your accounting package to have your orders booked.