Publish application

Publishing Your Application to the Bokio Marketplace

Before submitting your app to the Bokio Marketplace, ensure it is fully tested and in Production mode. The marketplace submission form is designed to provide users with all the necessary information about your integration. You will need to navigate to Marketplace tab and fill out the details.

📘

Marketplace access

Access to publish integrations on the developer portal is currently limited to selected partners.

If you're interested, please contact [email protected] and we’ll help enable access for you after signing a contract with you.

* Logo

For visual branding, the Application Icon / Logo should be a square image (e.g., 500×500 px) in PNG or SVG format.

* Application Name

The Application Name is the name displayed to users and should clearly reflect the app’s functionality. Keep it concise and avoid generic terms like “Integration” or “App,” while making sure it aligns with your branding. You need to provide this in both English and Swedish.

For naming integrations developed by third-party developers (i.e., developers not part of the company using the integration), we recommend a clear and consistent format for the integration title. For example: “Stripe by Developer company” This approach clearly identifies both the integration functionality and the responsible developer. Many leading platforms follow a similar convention, appending the developer or company name to the integration title to ensure transparency, build trust, and maintain a consistent marketplace experience.

* Short description

The Short Description is a brief explanation shown in the listing. It should hook users and highlight the core functionality in a maximum of 200 characters. For example, “Automatically exports your VAT reports to third-party accounting software, saving time and reducing errors.” You need to provide this in both English and Swedish.

* Detailed description

The Detailed Description provides a longer explanation of your app, including its features and benefits. It should include three main sections: what the product is, how the integration helps (value proposition), and how to connect or set it up. Use Markdown formatting for readability and bullet points only when listing features or steps. This section should follow Bokio’s tone of voice, keeping instructions clear and user-focused. You need to provide this in both English and Swedish.

* Tags

These are additional keywords for broader searches (e.g., Accounting, Productivity, CRM). Include 0-3 relevant, specific keywords. You need to provide this in both English and Swedish.

* Price model

The Pricing Model must be clearly stated, specifying whether your app is free, freemium, or paid. Include pricing and frequency (e.g., “SEK 150/month per user”) and ensure it matches your website. Transparent pricing improves user trust and adoption. You need to provide this in both English and Swedish.

* Category

Select the appropriate Category to help users discover your app in the published integrations list. The allowed categories include Payment Processing, Accounting & Bookkeeping, Banking & Finance, Time Tracking & HR, E-Commerce, Productivity & Automation, and Invoicing & Billing.

* Website link

The Website / Documentation URL should provide users with additional information, setup instructions, API references, or FAQs. It must be accessible without login. A clear, well-structured documentation reduces support requests.

* Support link

Similarly, the Support Contact / Email allows users to reach you for any issues, questions, or feedback.

* Privacy Policy URL

The Privacy Policy URL links to your app’s privacy policy, explaining how user data is collected, stored, and used. Bokio requires this so users understand what happens to their information before authorization. The page must be publicly accessible, cover data handling practices, and include a contact for privacy-related inquiries.

* Terms of Service URL

The Terms of Service URL provides the rules, responsibilities, and limitations associated with using your app. Make it easy to read, include necessary disclaimers, and ensure it is publicly accessible.

* Connect URL

The URL Bokio redirects users to start connecting your integration via OAuth. Your server then handles authorization and token exchange before returning the user to Bokio.

* Disconnect URL

The URL Bokio redirects users to when disconnecting your integration. Your server can clean up, call the API to delete the connection, and redirect back with a status.

* Screenshots

Screenshots or media help demonstrate your app’s functionality and workflow; upload up to three screenshots and annotate them if necessary to highlight key features. Avoid generic images and prefer real app screens.

Developer Tips & Best Practices

Always test integrations in Test mode before switching to Production. Keep your documentation clear and user-friendly. Use HTTPS for all callback URLs and protect credentials. Monitor API usage and errors to ensure reliability, and update your app as Bokio APIs evolve or new features are released.

For additional help, contact Bokio Developer Support via support link, providing your app details and any error logs.

If you edit a published integration, you need to both save draft and publish to marketplace again to make sure that the changes are also published.