Organizations and projects

An organization holds your projects, your members and your plan. A project holds sources, routes and the requests they receive.

How it works

When you sign up, you name your first organization, and Hookspot adds a Default project to it. You are its Owner. You can belong to several organizations and create more from the Organizations page.

Members join the organization, not a project, so a member’s role applies to every project in it. The organization’s plan sets its limits, as Plans and limits describes.

Roles

Role	What it allows
Owner	Everything an Admin can do, plus deleting projects and the organization. Nobody can change the Owner’s role or remove them.
Admin	Invite and remove members, change their roles, rename the organization and change the plan. Everything a Member can do.
Member	Create, change and delete sources and routes in every project, send test requests, replay requests and retry deliveries.
Viewer	Open projects, requests and deliveries, and see members and billing. Viewers cannot change sources or routes, replay requests or retry deliveries.

Invite a member

You need the Owner or Admin role.

1. Open the organization’s Settings › Members.
2. Under Invite by email, enter the address and pick Viewer, Member or Admin.
3. Click Invite.

Hookspot shows Invitation sent and emails a link. Someone with a Hookspot account joins when they open it. Someone new creates an account on the Accept invitation page.

If the form is disabled, every seat is taken. Members explains how to free one.

To change a member’s role, pick another one in the Role column. To remove a member, click Remove in the row’s menu.

Create a project

1. Open the organization’s Overview and click New project.
2. Enter a Name. Hookspot fills in the Slug from it.
3. Click Create project.

Hookspot shows Project successfully created and opens the new project.

Choose the CLI’s project

hookspot listen receives deliveries from one project, the CLI’s active project. You pick it when you approve hookspot login. To switch, name the organization and the project:

hookspot project use "Documentation demo" "Default project"

✓ Active project set to Documentation demo | Default project

Run hookspot project use with no arguments to pick from a list, and hookspot project list to see every project you can open.