Loomio Integration API

Hi. We've created this API just for people who are writing integrations for Loomio. At this stage it's still very new, and development is user request driven - meaning that if you are needing help or want to see a new function then join the product development group and tell us.

create discussion

curl -X POST -d 'title=hello world&api_key=x' http://localhost:3000/api/b1/discussions

params

title title of the thread
description context for the thread
description_format either 'md' or 'html'
recipient_audience 'group' or null. if 'group' whole group will be notified about the new thread
recipient_user_ids array of user ids to notify or invite to the thread
recipient_emails array of email addresses of people to invite to the thread
recipient_message message to include in the email invitation

show discussion

Fetch a discussion using the discussion id (an integer) or key (a string) using the following request format

EG: curl http://localhost:3000/api/b1/discussions/1234?api_key=x
EG: curl http://localhost:3000/api/b1/discussions/aBcD123?api_key=x

create poll

curl -X POST -d 'title=vote now&poll_type=proposal&options[]=agree&options[]=disagree&details=yo wassup&closing_at=2021-02-03&api_key=x' http://localhost:3000/api/b1/polls

params

title title of the thread
poll_type proposal, poll, count, score, ranked_choice, meeting or dot_vote the voting style of the poll
details the main text of the poll
details_format either 'md' or 'html'
specified_voters_only boolean if true, only invited people can vote, if false, anyone in the group or thread can vote
hide_results_until_closed boolean allow voters to see the results before the poll has closed
anonymous boolean hide identities of voters
discussion_id integer id of discussion thread to add this poll to
voter_can_add_options boolean if voters can add options to the poll
recipient_audience 'group' or null. if 'group' whole group will be notified about the new thread
notify_on_closing_soon nobody, author, undecided_voters or voters audience to send a reminder notification to, 24 hours before the poll closes
options[] string. when proposal then agree, disagree, abstain, block. when meeting then a iso8601 date or datetime. otherwise it's anything goes. options to include in the poll. send multiple options[] arguments to add to the array of options
recipient_user_ids array of user ids to notify or invite
recipient_emails array of email addresses of people to invite to the thread
recipient_message message to include in the email invitation

show poll

Fetch a poll using the poll id (an integer) or key (a string)

EG: curl http://localhost:3000/api/b1/polls/1234?api_key=x
EG: curl http://localhost:3000/api/b1/polls/aBcD123?api_key=x

list memberships

http://localhost:3000/api/b1/memberships?api_key=x
curl -d 'api_key=x' http://localhost:3000/api/b1/memberships