Skip to main content
llms.txt

Set up and use Coworkies in Slack

Install Coworkies in Slack to post jobs, see your active listings and manage hiring for yourself or your coworking space.

Choose My own jobs if you’re hiring without a Coworkies space. To post for a coworking space, choose the confirmed space you own or help manage as a Team Member.

Install the app once for your Slack workspace. Each person who wants to post then runs /coworkies setup and connects their own verified Coworkies account or enters a space API key.

1. Install the Slack app

  1. Open the Coworkies for Slack pilot installation page.
  2. Select Add to Slack.
  3. Choose the intended Slack workspace and review the permissions. Your workspace may require administrator approval.
  4. Complete installation in the same browser, then open Slack and run /coworkies setup.

Finish in the same browser within ten minutes. If the link expires, open the Coworkies for Slack page to start again.

2. Choose how to connect

Setup shows your current connection first. Expand Show options to see connection choices; First time here? contains onboarding guidance. Each Slack member can connect one hiring account per Slack workspace: their own jobs or one managed space.

No API key: Set up on Coworkies

  1. Choose Set up on Coworkies.
  2. Sign in to your own active Coworkies account and verify your email if needed.
  3. Choose My own jobs, or a confirmed space where you are an owner or Team Member (staff).
  4. Review and confirm the connection.
  5. Select Back to Slack, then run /coworkies new when ready.

No existing API key or Pro subscription is required for this account connection. Coworkies creates a separate Slack credential valid for 90 days. Hiring and publication rules still apply.

No space is needed for My own jobs. If a managed space is missing, check its confirmation and your owner/team role. An ordinary space membership is insufficient. Follow Space setup or ask the space owner to grant the appropriate team access.

Already have a key: Enter API key in Slack

  1. Choose Enter API key in setup.
  2. Paste a live, ordinary space API key into the private modal.
  3. Select Check key and review the detected space.
  4. Select Connect to confirm. Permissions are checked again at confirmation.

The key needs job read/write authority and a key owner who currently manages that confirmed space. Test keys, platform/admin keys and existing assistant credentials are rejected. The pending connection expires after ten minutes. A raw key can belong to only one Slack member/workspace connection; create a dedicated key for each publisher.

The key is visible while you type and passes through Slack. Never send it in a channel or direct message. Coworkies stores the connected copy encrypted; its existing permissions, expiry and request restrictions remain in force.

Holding a manager’s key allows you to use that manager’s authority without independently signing in to Coworkies. Only share a key when you intend to delegate that access.

Create manual keys in User settings → API tokens for a confirmed Pro space you manage. Manage tokens.

Prefer the website: Use an API key

Choose Set up on Coworkies, then the website’s Use an API key option. Sign in as the key’s owner, enter it in the masked field and confirm. The source key identifies the space; Coworkies issues a separate Slack credential rather than storing that source key as the connection.

This route rejects keys restricted to a network or origin, plus platform/admin, test and assistant keys. The original key is neither adopted nor revoked by this setup.

3. Use the commands

CommandResult
/coworkies setupCheck connection status, change hiring account, reconnect or open setup options.
/coworkies newOpen the job form and choose Free or Standard. Review the details before Confirm submission and check the returned publication status.
/coworkies listPrivately list active jobs you authored, ten per page. Choose Include all my posts and approve on Coworkies to include personal jobs and posts for spaces you still manage.
/coworkies list accountShow active jobs for the selected hiring account, including posts by its team.
/coworkies list optionsOpen setup to choose your hiring account.
/coworkies pro 6 or /coworkies pro 12Review the term, price and beneficiary on Coworkies before purchase.
/coworkies delete <job_id>Unpublish a job in the connected hiring account.
/coworkies helpShow command help.
/coworkies disconnectRemove your personal connection in this workspace.

In a channel only you see the list reply. In a direct message it appears in your conversation with the bot. Cross-account listing grants read access only. To edit or unpublish outside your posting account, follow the job’s website link, sign in and check the exact job before confirming.

The Slack form offers full-time, part-time, freelance and internship. If you need the distinct contract job type, use the Jobs API or MCP.

Change hiring account or disconnect

Use /coworkies setup to change between personal hiring and an eligible space, or reconnect. Website completion returns you to Slack.

Disconnecting leaves your colleagues’ connections and your published jobs in place. If you entered a space API key in Slack, the original key stays active. If you uninstall or reinstall the app, reconnect and start any pending drafts again. Check My Jobs before resubmitting a job you already sent.

Personal hiring allowance

Personal hiring API requests share 20 per minute and 1,000 per UTC day per Coworkies user across Slack and MCP, including identity checks. These are request limits, not included paid posts. Reconnecting or adding another Slack workspace does not reset them. If a request fails, check your jobs on Coworkies before trying again.

Choose Free for the existing 30-day basic listing, without paid promotion, or Standard to use hiring credit or complete checkout. Choose the listing option explicitly in the Slack form. A paid draft is not a published job.

Troubleshooting

ProblemWhat to do
Installation link expired or does not match this browserStart again from the Coworkies Slack page in the same browser. Do not reuse the failed callback tab or a saved authorization URL.
No eligible spaceChoose My own jobs for personal hiring. For space jobs, verify confirmation and your owner/Team Member role. Slack administration alone is insufficient.
Key rejected or access deniedCheck key type, job scopes, expiry, restrictions and its owner’s current space role. Use a separate key for each publisher.
Connection expiredRun /coworkies setup and reconnect.
Job remains a draft or requires paymentFollow the returned result and complete any checkout on Coworkies. Connection permission does not include unlimited publication.
Timeout or uncertain resultCheck your connected jobs in Coworkies before submitting again; the first write may already have succeeded.

For a blocked form, HTML security challenge or repeated failure, report the error through Contact support. Do not disable browser security or share credentials. See Permissions for the full access rules.