Create connection

post

https://{tenant}.onechurchsoftware.com/api/connections

Create a new connection for a person. Returns the id and type name of the new connection.

Required permission: Full Write Connections

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The details of the new connection

type

object | null

required

The connection's type. On a connection only the type's id, code, name and fields are populated, and the fields are filtered to this connection's responses. Set the type by code when creating; the type cannot be changed on update.

person

object | null

required

The person the connection is about. Set the person by id when creating; it cannot be changed afterward.

status

object | null

required

The connection's status. Set by code.

date

date-time | null

required

The connection's effective date.

fields

array of objects | null

Custom fields for this object

fields

campus

object | null

The campus (location) the connection belongs to. Set by id, or omit to clear.

assignee

object | null

The person the connection is assigned to. Set by id, or omit to leave it unassigned; changing the assignee emails the new and former assignees.

due

date-time | null

The connection's due date. Required when an assignee is set.

completed

date-time | null

The date the connection was completed. Required when the status is completed.

outcome

string | null

The connection's outcome notes.

comments

string | null

The connection's initial notes.

comment

string | null

Adds a new comment to the connection when saving. To add a comment on its own, use /api/connections/{id}/comments.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

text/json

200OK

404Not Found