Skip to main content
View as Markdown

Connections

Find the actions recorded when users connect, send connection requests or create contacts, and the fields each one returns.

Each action name below is a value of the event field in the export response. Pass it in the events filter to export only that action. Body lists the fields of the action's body object. Actions labelled Has recipient also return the with_* fields of the other user.

Connections​

Action

  • connection_createstringHas recipient

    When a connection is created (one per user).

  • connection_updatestringHas recipient

    When the connection rating is updated.

Body

  • ratingfloatNullable

    Rating between 0 and 5.

  • scannedbool

    Whether the connection comes from a scan.

Connection requests​

Action

  • connection_request_createstringHas recipient

    When the user sends a connection request to another user.

  • connection_request_updatestringHas recipient

    When the status of the connection request changes.

Body

  • statusstring

    One of ACCEPTED, DECLINED, PENDING.

Contacts​

A contact is a connection with someone who isn't a Swapcard user.

Action

  • contact_connection_createstring

    When the user creates a contact with a non-user.

Body

  • with_contact_idstring

    The ID of the contact created.

  • scannedbool

    Whether the connection comes from a scan.