Create or update a member
POST {{baseUrl}}/:workspace_slug/members
This method is useful when you know a member's identity in another system and want to create or update the corresponding Orbit member. Identities can be specified in the identity object or member attributes like member.github. If no member exists, a new member will be created and linked to any provided identities.
Request Body
{"member"=>{"bio"=>"<string>", "birthday"=>"<string>", "company"=>"<string>", "title"=>"<string>", "location"=>"<string>", "name"=>"<string>", "pronouns"=>"<string>", "shipping_address"=>"<string>", "slug"=>"<string>", "tags_to_add"=>"<string>", "tags"=>"<string>", "tag_list"=>"<string>", "tshirt"=>"<string>", "teammate"=>"<boolean>", "url"=>"<string>", "github"=>"<string>", "twitter"=>"<string>", "email"=>"<string>", "linkedin"=>"<string>", "devto"=>"<string>"}, "identity"=>{"source"=>"<string>", "name"=>"<string>", "source_host"=>"<string>", "username"=>"<string>", "uid"=>"<string>", "email"=>"<string>", "url"=>"<string>"}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"data":{"id":"jdpSxX","type":"member","attributes":{"activities_count":0,"activities_score":0,"avatar_url":"https://avatars2.githubusercontent.com/u/174777?u=79e423dd07c19122115f52a1c97727ca193e6253\u0026v=4","bio":"Co-founder \u0026 CTO @orbit-love · Developer Advocate · formerly @algolia and @keen","birthday":null,"company":"@orbit-love","title":null,"created_at":"2022-03-22T10:10:40.231Z","deleted_at":null,"first_activity_occurred_at":null,"last_activity_occurred_at":null,"location":"Paris","name":"Josh Dzielak","pronouns":null,"reach":8,"shipping_address":null,"slug":"dzello","source":"api","tag_list":["one","two"],"tags":["one","two"],"teammate":false,"tshirt":null,"updated_at":"2022-03-22T10:10:40.353Z","merged_at":null,"url":"https://dzello.com/","orbit_url":"http://localhost:3000/marshallschmeler/members/dzello","created":true,"id":"jdpSxX","orbit_level":null,"love":null,"twitter":"dzello","github":"dzello","discourse":null,"email":"josh@orbit.love","devto":null,"linkedin":null,"discord":null,"github_followers":171,"twitter_followers":null,"topics":null,"languages":null},"relationships":{"identities":{"data":[{"id":"nqaT2R","type":"github_identity"},{"id":"1mzT7N","type":"twitter_identity"},{"id":"32LTa0","type":"email_identity"}]}}},"included":[{"id":"nqaT2R","type":"github_identity","attributes":{"uid":"174777","email":null,"username":"dzello","name":"Josh Dzielak","source":"github","source_host":"github.com"}},{"id":"1mzT7N","type":"twitter_identity","attributes":{"uid":null,"email":null,"username":"dzello","name":null,"source":"twitter","source_host":"twitter.com"}},{"id":"32LTa0","type":"email_identity","attributes":{"uid":"josh@orbit.love","email":"josh@orbit.love","username":null,"name":"josh","source":"email","source_host":"email.host"}}]}