/orgs/{org_id}
DELETE
GET
PATCH
/orgs/{org_id}/invites
GET
POST
/orgs/{org_id}/invites/{invite_id}
DELETE
GET
/orgs/{org_id}/join_forms
Join forms are a way of setting up a channel through which people can join the organization without first creating a Zetkin user. This is useful to do things like creating a form on your website and submitting the data straight into Zetkin.
The form is configured to accept certain fields, and a set of tags that will be attached to any person created through the form.
Since forms can be submitted anonymously (without authenticating with the API), submissions require a token which is unique per form.
GET
Get list of join forms. Each join form is it’s own configuration of accepted fields and tags that will be assigned when a submission is accepted.
POST
/orgs/{org_id}/join_forms/{form_id}
DELETE
GET
PATCH
/orgs/{org_id}/join_forms/{form_id}/submissions
GET
POST
Submit a join form and create a submission which will then need to be accepted
by an official using PATCH on the submission item.
The data must contain the submit_token of the form, and a form_data object
containing the fields that the form has been configured to accept.
{
"submit_token": "abc123def456",
"form_data": {
"first_name": "Clara",
"last_name": "Zetkin",
}
}
/orgs/{org_id}/join_requests
GET
POST
/orgs/{org_id}/join_submissions
Collection of all join form submissions.
GET
/orgs/{org_id}/join_submissions/{sub_id}
Single join form submission.
DELETE
GET
PATCH
Allows the state of a submission to be changed from "pending" to "accepted",
which will create a person in the organization from the submitted data, and assign
the tags configured on the join form.