Seayora Developers: Build and Publish an App

Join the developer program, register an app, test it in the sandbox with your own testers, and submit it for production — with the limits, the review and the rules an app lives by.

Seayora Developers is where you build software that connects to Seayora: an integration for your product, an AI agent, a tool for your own business. Any Seayora account can join, and you can create an account just for building. It is free, and Seayora takes no share of what your app charges.

Start at https://seayora.com/developers. Sign in or sign up there with any way you already use — a password, a code, a passkey, Google or Apple — and you land in the developer console. On a phone, every app you have is under Tools → Developer apps.

Joining

The first time you open the console you set up your developer profile — the name your apps are published under, your company, what kind of developer you are, an email for messages about your apps, and who you build for — and accept the program terms. Seayora records the version you accepted; when the terms change you are asked to accept them again before you can change an app.

Registering an app

  • Name it, say what kind of app it is and what it does. Customers read this on the consent screen, so write it for them. An app’s name may not contain “Seayora”.
  • Choose who it is for and what it does with an account.
  • Choose its permissions. Ask only for what it needs; a permission that changes records needs a sentence saying why.
  • Choose how it signs customers in: a web app or server keeps a client secret; a phone, tablet or desktop app has no secret and proves itself with PKCE.
  • Add its redirect URIs, privacy policy, support email and logo, and answer the questions about how it handles customers’ data.

Registering gives you sandbox credentials straight away. A client secret is shown once — copy it then; Seayora keeps only a fingerprint. You can make a new one at any time, and the old one stops working at once.

The sandbox

  • Only you and the testers you add can connect a sandbox app. Each tester signs in with their own Seayora account; anyone else is refused on the consent screen.
  • In the sandbox an app reads freely, but every change it tries is refused as test-mode unless Seayora allows sandbox writes for it.
  • The consent screen tells the person connecting that the app is in development and has not been reviewed.
  • Removing a tester ends their sandbox connection at once.

Going to production

When the app is ready, submit it from its Production review tab, with step-by-step instructions for our reviewer and, if you like, a demo video. The console lists anything still missing before it lets you submit. Never give us a Seayora password — our reviewer uses their own test account.

  • A person reads the app, every permission it asks for and why, how it handles customers’ data, and tries it.
  • We email you the decision. Approved: the app gets production credentials, and any Seayora customer can connect it within the permissions we approved — which may be fewer than you asked for. Changes requested or not approved: the email carries the reviewer’s reason word for word, the app keeps working in the sandbox, and you can change it and submit again.
  • An approved app asking for new permissions is reviewed again; production keeps its approved permissions until then.
  • You can withdraw a submission at any time before it is decided.

Limits

Every app has a limit on requests a minute for each connected account, and may have a daily total across the whole app, a per-minute ceiling across all its connections, and a cap on how many accounts may connect it. The console shows the limits in force for each app. A request over a limit is answered 429 with a Retry-After header. Seayora can raise or lower an app’s limits at any time and emails you when it does.

The rules

  • Use customers’ data only for what your app’s registration says, never sell it or advertise with it, and delete it when a customer disconnects, except where the law requires otherwise.
  • No app may move money, make a credit or tenant-screening decision, or contact a customer’s residents, customers or tenants without that customer’s permission.
  • Keep secrets secret, and tell [email protected] within 72 hours if one may have been exposed.
  • Seayora may suspend an app or a developer account, or end its connections, at any time to protect customers — and tells you why. The full terms are in the Developer Program section of the Terms of Service.

Frequently asked questions

Does it cost anything?

No. Joining, the sandbox, review and production are free, and Seayora takes no share of what your app charges.

Can I use my existing Seayora account?

Yes. A landlord, a management company or a contractor can join with the account they already have; the developer console is a separate place in the same account.

Why was a write refused in the sandbox?

Sandbox apps are read-only unless Seayora allows sandbox writes for that app. The refusal says sandbox_read_only. Ask in your submission notes if you need writes while testing.

Can my app take payments?

No. Nothing in the API charges, refunds or pays anybody. If your app charges customers, you bill them yourself.

Related guides

Related features and guides

Explore Seayora