Ballerina library

orbitcrm

Module orbitcrm

OverviewPrerequisitesQuickstart

API

Client

Definitions

Activity
ActivityAndIdentity
ActivityWithMember
ClientHttp1Settings
ConnectionConfig
Identity
Member
MemberAndIdentity
Note
PostActivity
PostActivityWithMember
ProxyConfig

CustomOrPostActivity

ballerinax/orbitcrm Ballerina library

1.5.2

Overview

The Orbit API v1 connector(https://docs.orbit.love/reference/about-the-orbit-api) OpenAPI specification.

Orbit API used to track activities of users and manage users.

Key Features

  • Programmatic access to create and manage resources via REST API
  • Manage user accounts and profiles
  • Secure authentication with API key or OAuth support

Prerequisites

Before using this connector in your Ballerina application, complete the following:

Quickstart

Step 1: Import connector

Import the ballerinax/orbitcrm module into the Ballerina project.

Copy
import ballerinax/orbitcrm;

Step 2: Create a new connector instance

Add the project configuration file by creating a Config.toml file. Config file should have following configurations. Add the tokens obtained in the previous step to the Config.toml file.

Copy
[auth]
token = "<Bearer_token">
Copy
configurable http:BearerTokenConfig & readonly auth = ?;
orbitcrm:ClientConfig clientConfig = {auth : auth};

orbitcrm:Client myclient = check new orbitcrm:Client(clientConfig, {}, "https://app.orbit.love/api/v1");

Step 3: Invoke connector operation

  1. You can get activity details as follows with getActivitiesById method by passing Id of a work sheet as a parameter. Successful creation returns the json containing activity detail and the error cases returns an error object. 
    Copy
    orbitcrm:json result = check myclient->getActivitiesById(<Workspace_ID>);
  2. Use bal run command to compile and run the Ballerina program.

Clients

orbitcrm: Client

Isolated

This is a generated connector for Orbit API v1 OpenAPI specification. Orbit API used to track activities of users and manage users.

Constructor

Gets invoked to initialize the connector. The connector initialization requires setting the API credentials. Create an Orbit Account and obtain tokens by following this guide.

init (ConnectionConfig config, string serviceUrl)
  • config ConnectionConfig - The configurations to be used when initializing the connector
  • serviceUrl string "https://app.orbit.love/api/v1" - URL of the target service

getActivityTypes

Isolated FunctionRemote Function
function getActivityTypes() returns json|error

Get all activity types

Return Type

getCurrentUser

Isolated FunctionRemote Function
function getCurrentUser() returns json|error

Get info about the current user

Return Type

getWorkspaces

Isolated FunctionRemote Function
function getWorkspaces() returns json|error

Get all workspaces for the current user

Return Type

getWorkspaceById

Isolated FunctionRemote Function
function getWorkspaceById(string workspaceId) returns json|error

Get a workspace

Parameters
  • workspaceId string - Workspace ID
Return Type

getActivitiesInWorkspace

Isolated FunctionRemote Function
function getActivitiesInWorkspace(string workspaceId, string? activityTags, string? affiliation, string? memberTags, string? orbitLevel, string? activityType, string? weight, string? identity, string? location, string? company, string? startDate, string? endDate, string? page, string? direction, string? items, string? sort, string? 'type) returns json|error

List activities for a workspace

Parameters
  • workspaceId string - Workspace ID
  • activityTags string? (default ()) - Activity tags allow to group activities
  • affiliation string? (default ()) - Association with either 'member' or 'teammate'
  • memberTags string? (default ()) - Member tags allow to group members
  • orbitLevel string? (default ()) - Orbit level
  • activityType string? (default ()) - Activity type related to activities
  • weight string? (default ()) - Weighted score of activity
  • identity string? (default ()) - Activity identity of platforms
  • location string? (default ()) - Identifier for the location
  • company string? (default ()) - Identifier for the company
  • startDate string? (default ()) - Activity start date
  • endDate string? (default ()) - Activity end date
  • page string? (default ()) - Page of the activities
  • direction string? (default ()) - Sort activities 'ASC' if Ascending and 'DESC' if Descending
  • items string? (default ()) - Number of activities
  • sort string? (default ()) - Sort activities by properties of activity
  • 'type string? (default ()) - Type related to activities
Return Type

postActivitiesById

Isolated FunctionRemote Function
function postActivitiesById(string workspaceId, ActivityAndIdentity payload) returns json|error

Create a Custom or a Content activity for a new or existing member

Parameters
  • workspaceId string - Workspace ID
Return Type

getActivitiesById

Isolated FunctionRemote Function
function getActivitiesById(string workspaceId, string id) returns json|error

Get an activity in the workspace

Parameters
  • workspaceId string - Workspace ID
Return Type

getMembers

Isolated FunctionRemote Function
function getMembers(string workspaceId, string? activityTags, string? affiliation, string? memberTags, string? orbitLevel, string? activityType, string? weight, string? identity, string? location, string? company, string? startDate, string? endDate, string? query, string? page, string? direction, string? items, string? activitiesCountMin, string? activitiesCountMax, string? sort, string? 'type) returns json|error

List members in a workspace

Parameters
  • workspaceId string - Workspace ID
  • activityTags string? (default ()) - Activity tags allow to group activities
  • affiliation string? (default ()) - Association with either 'member' or 'teammate'
  • memberTags string? (default ()) - Member tags allow to group members
  • orbitLevel string? (default ()) - Orbit level
  • activityType string? (default ()) - Activity type related to activities
  • weight string? (default ()) - Weighted score of activity
  • identity string? (default ()) - Activity identity of platforms
  • location string? (default ()) - Identifier for the location
  • company string? (default ()) - Identifier for the company
  • startDate string? (default ()) - Activity start date
  • endDate string? (default ()) - Activity end date
  • query string? (default ()) - Activity query
  • page string? (default ()) - Page of the members
  • direction string? (default ()) - Organise activities 'ASC' if Ascending and 'DESC' if Descending
  • items string? (default ()) - Number of members
  • activitiesCountMin string? (default ()) - Minumum count of activities
  • activitiesCountMax string? (default ()) - Maximum count of activities
  • sort string? (default ()) - Sort activities by properties of activity
  • 'type string? (default ()) - Type related to activities
Return Type

postMembers

Isolated FunctionRemote Function
function postMembers(string workspaceId, MemberAndIdentity payload) returns json|error

Create or update a member

Parameters
  • workspaceId string - Workspace ID
Return Type

findMembers

Isolated FunctionRemote Function
function findMembers(string workspaceId, string? 'source, string? sourceHost, string? uid, string? username, string? email, string? github) returns json|error

Find a member by an identity

Parameters
  • workspaceId string - Workspace ID
  • 'source string? (default ()) - Source of member in a workspace
  • sourceHost string? (default ()) - Source host of member in a workspace
  • uid string? (default ()) - Unique identifier of member in a workspace
  • username string? (default ()) - Username of member in a workspace
  • email string? (default ()) - Email of member in a workspace
  • github string? (default ()) - Deprecated, please use source=github and username=<username> instead
Return Type

getMembersById

Isolated FunctionRemote Function
function getMembersById(string workspaceId, string id) returns json|error

Get a member

Parameters
  • workspaceId string - Workspace ID
Return Type

updateMembersById

Isolated FunctionRemote Function
function updateMembersById(string workspaceId, string id, Member payload) returns Response|error

Update a member

Parameters
  • workspaceId string - Workspace ID
  • payload Member - Update member
Return Type

deleteMembersById

Isolated FunctionRemote Function
function deleteMembersById(string workspaceId, string id) returns Response|error

Delete a member

Parameters
  • workspaceId string - Workspace ID
Return Type

getActivities

Isolated FunctionRemote Function
function getActivities(string workspaceId, string memberId, string? page, string? direction, string? items, string? sort, string? activityType, string? 'type) returns json|error

List activities for a member

Parameters
  • workspaceId string - Workspace ID
  • page string? (default ()) - Page of the activities
  • direction string? (default ()) - Sort activities 'ASC' if Ascending and 'DESC' if Descending
  • items string? (default ()) - Number of activities
  • sort string? (default ()) - Sort activities by properties of activity
  • activityType string? (default ()) - Activity type related to activities
  • 'type string? (default ()) - Type related to activities
Return Type

postActivities

Isolated FunctionRemote Function
function postActivities(string workspaceId, string memberId, Activity payload) returns json|error

Create a Custom or a Content activity for a member

Parameters
  • workspaceId string - Workspace ID
  • payload Activity - Create member activity
Return Type

updateActivityById

Isolated FunctionRemote Function
function updateActivityById(string workspaceId, string memberId, string id, Activity payload) returns Response|error

Update a custom activity for a member

Parameters
  • workspaceId string - Workspace ID
  • payload Activity - Update member activity
Return Type

deleteActivityById

Isolated FunctionRemote Function
function deleteActivityById(string workspaceId, string memberId, string id) returns Response|error

Delete a post activity

Parameters
  • workspaceId string - Workspace ID
Return Type

postIdentities

Isolated FunctionRemote Function
function postIdentities(string workspaceId, string memberId, Identity payload) returns json|error

Add identity to a member

Parameters
  • workspaceId string - Workspace ID
Return Type

deleteIdentities

Isolated FunctionRemote Function
function deleteIdentities(string workspaceId, string memberId) returns Response|error

Remove identity from a member

Parameters
  • workspaceId string - Workspace ID
Return Type

getNotes

Isolated FunctionRemote Function
function getNotes(string workspaceId, string memberId, string? page) returns json|error

Get the member's notes

Parameters
  • workspaceId string - Workspace ID
  • page string? (default ()) - Page of the notes
Return Type

postNotes

Isolated FunctionRemote Function
function postNotes(string workspaceId, string memberId, Note payload) returns json|error

Create a note

Parameters
  • workspaceId string - Workspace ID
  • payload Note - Create note
Return Type
  • json|error - note created

updateNoteById

Isolated FunctionRemote Function
function updateNoteById(string workspaceId, string memberId, string id, Note payload) returns Response|error

Update a note

Parameters
  • workspaceId string - Workspace ID
  • payload Note - Update note
Return Type

getReports

Isolated FunctionRemote Function
function getReports(string workspaceId, string? startDate, string? endDate, string? group, string? activityType, string? 'type) returns json|error

Get a workspace stats

Parameters
  • workspaceId string - Workspace ID
  • startDate string? (default ()) - Report start date
  • endDate string? (default ()) - Report end date
  • group string? (default ()) - Group in report generation
  • activityType string? (default ()) - Activity type related to activities
  • 'type string? (default ()) - Report type to generate
Return Type

Records

orbitcrm: Activity

Activities are instances of community participation and contribution.

Fields
  • activity_type? string - The type of activity - what action was done by the member
  • description? string - A description of the activity; displayed in the timeline
  • 'key? string - Supply a key that must be unique or leave blank to have one generated.
  • link_text? string - The text for the timeline link
  • occurred_at? string - The date and time the activity occurred; defaults to now
  • tags? string[] - [EXPERIMENTAL] Capture facets of the activity to group by later e.g. locations or channels; replaces existing value
  • title string - A title for the activity; displayed in the timeline
  • weight? string - A custom weight to be used in filters and reports; defaults to 1.

orbitcrm: ActivityAndIdentity

Fields
  • identity? Identity - Represents an email address, a profile on networks like github and twitter, or a record in another system.

orbitcrm: ActivityWithMember

Fields
  • member? Member - Members are the people in the community.

orbitcrm: ClientHttp1Settings

Closed record

Provides settings related to HTTP/1.x protocol.

Fields
  • keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests
  • chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request

orbitcrm: ConnectionConfig

Closed record

Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.

Fields
  • httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
  • timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
  • forwarded string(default "disable") - The choice of setting forwarded/x-forwarded header
  • cache? CacheConfig - HTTP caching related configurations
  • compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (accept-encoding) header
  • circuitBreaker? CircuitBreakerConfig - Configurations associated with the behaviour of the Circuit Breaker
  • retryConfig? RetryConfig - Configurations associated with retrying
  • validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default

orbitcrm: Identity

Represents an email address, a profile on networks like github and twitter, or a record in another system.

Fields
  • email? string - The email of the person in the source system
  • name? string - The name of the person in the source system
  • 'source string - The type of source: known values include github, twitter, discourse, email, linkedin, devto. Custom values can also be used
  • source_host? string - Specifies the location of the source, such as the host of a Discourse instance
  • uid? string - The uid of the person in the source system
  • url? string - For custom identities, an optional link to the profile on the source system
  • username? string - The username of the person in the source system

orbitcrm: Member

Members are the people in the community.

Fields
  • bio? string - The member’s bio
  • birthday? string - The member’s birthday, e.g. August 1
  • company? string - The member’s company
  • devto? string - The member's dev.to username
  • email? string - The member's email
  • github? string - The member's GitHub username
  • linkedin? string - The member's LinkedIn username, without the in/ or pub/
  • location? string - The member’s location. That field is not normalized and reflects what can be found in the member’s identities.
  • name? string - The member’s name
  • pronouns? string - The member’s pronouns
  • shipping_address? string - The member’s shipping address
  • slug? string - The member’s slug in the Orbit app
  • tag_list? string - Deprecated: Please use the tags attribute instead
  • tags? string - Replaces all tags for the member; comma-separated string or array
  • tags_to_add? string - Adds tags to member; comma-separated string or array
  • teammate? boolean - Whether the member is a teammate
  • title? string - The member’s title
  • tshirt? string - The member’s tshirt size
  • twitter? string - The member’s Twitter username, if available. null otherwise
  • url? string - The URL listed by the member in one of their profiles

orbitcrm: MemberAndIdentity

Fields
  • identity? Identity - Represents an email address, a profile on networks like github and twitter, or a record in another system.
  • member? Member - Members are the people in the community.

orbitcrm: Note

A member's notes are free-form areas to attach information to a member's profile.

Fields
  • body string - The body of member's note

orbitcrm: PostActivity

Fields
  • activity_type string - Activity type related to activities
  • occurred_at? string - The date and time at which the content was published; defaults to now
  • url string - The url representing the post

orbitcrm: PostActivityWithMember

Fields
  • member? Member - Members are the people in the community.

orbitcrm: ProxyConfig

Closed record

Proxy server configurations to be used with the HTTP client endpoint.

Fields
  • host string(default "") - Host name of the proxy server
  • port int(default 0) - Proxy server port
  • userName string(default "") - Proxy server username
  • password string(default "") - Proxy server password

Union types

orbitcrm: CustomOrPostActivity

Activity|PostActivity

CustomOrPostActivity

Import

import ballerinax/orbitcrm;Copy

Other versions

1.5.2

1.5.11.5.01.4.01.2.0
See more...

Metadata

Released date: 3 days ago

Version: 1.5.2

License: Apache-2.0

Compatibility

Platform: any

Ballerina version: 2201.8.0

GraalVM compatible: Yes

Pull count

Total: 27

Current verison: 0

Weekly downloads

Source repository

Keywords

Type/Connector

Vendor/Orbit

Area/CRM & Sales

Sales & CRM/Customer Relationship Management

Cost/Freemium

Contributors

Dependencies

ballerina/url/2.4.0ballerina/http/2.10.24

Terms of service

Privacy policy

Cookie policy

Delete policy

© 2026 WSO2 LLC