Skip to main content
API docs by Redocly

V5ApiPrivate (1.0)

Download OpenAPI specification:Download

This is the private API for Tiltify. It includes endpoints that require specific oauth scopes in order to access. It can be considered as an extension to the public api, but with additional endpoints that may return sensitive information.

Authorization

Authorization # Please see the public api documentation for additional authorization instructions.

OAuth

OAuth 2.0 endpoints

Authorize

Returns a code through the applications redirect_uri to be used with the /token with the authorization_code grant.

Authorizations:
authorization
query Parameters
client_id
required
string

Client Id

redirect_uri
required
string

Redirect URI

response_type
required
string
Value: "code"

Response Type

scope
string
Default: "public"
Enum: "public" "cause" "webhooks:write"

Scope

Token

Returns an access and refresh token with a provided client id, secret, and grant type. Tokens expire in 7200 seconds.

Authorizations:
authorization
query Parameters
client_id
required
string

Client Id

client_secret
required
string

Client Secret

grant_type
required
string
Default: "client_credentials"
Enum: "client_credentials" "authorization_code" "refresh_token"

Grant Type

code
string

Authorization Code; *required if using authorization_code grant type

refresh_token
string

Refresh Token; *required if using refresh_token grant type

scope
string
Default: "public"
Enum: "public" "cause" "webhooks:write"

Scope

Responses

Response samples

Content type
application/json
{
  • "access_token": "ab6a592346444dea97170837e104d8a5ab6a592346444dea97170837e104d8a5",
  • "created_at": "2023-01-27T19:32:03Z",
  • "expires_in": 7200,
  • "refresh_token": "njjjytm3otetmgrjmi00yjawlwe4zgytzjixy2mzm2y3njawcg121231999393a3",
  • "scope": "public",
  • "token_type": "bearer"
}

Webhook

Webhook endpoints

Activates a webhook endpoint

Requires scope:webhooks:write

This endpoint will activate a given webhook endpoint. Webhook endpoints may be deactivated if they fail to respond sucessfully to our webhooks. This endpoint can be called programatically to ensure that your webhook endpoint is enabled when your listening application starts.

Authorizations:
authorization
path Parameters
webhook_endpoint_id
required
string

Webhook Endpoint ID

Responses

Response samples

Content type
application/json
{
  • "activated_at": "2025-09-09T17:20:27.871173Z",
  • "deactivated_at": null,
  • "description": "My Webhook Endpoint for Tiltify Fundraisers.",
  • "id": "9c365c2a-8502-44fc-835e-f2de6663d650",
  • "inserted_at": "2025-09-09T17:20:27.871211Z",
  • "status": "active",
  • "updated_at": "2025-09-09T17:20:27.871215Z",
  • "url": "https://webhooks.tiltify.test/endpoint"
}

Deletes a Webhook Subscription

Requires scope:webhooks:write

Deletes a Webhook Subscription to a given webhook_endpoint_id and event_id. This will either delete an existing webhook subscription to the given event or return a null value if the subscription no longer exists.

Authorizations:
authorization
path Parameters
webhook_endpoint_id
required
string

Webhook Endpoint ID

event_id
required
string

Campaign/Team Campaign/Fundraising Event public_id

Responses

Response samples

Content type
application/json
{
  • "event_id": "51d3edd8-acbb-4818-a64a-4a86596dda41",
  • "event_types": [
    ],
  • "id": "daa10209-7a52-4e63-aa7c-32470ae4fdbd",
  • "inserted_at": "2025-09-09T18:27:02.645749Z",
  • "updated_at": "2025-09-09T18:27:02.645765Z",
  • "webhook_endpoint_id": "e704d55c-8a85-431a-9816-2d01292da666"
}

Creates or Updates a Webhook Subscription

Requires scope:webhooks:write

Creates or Updates a Webhook Subscription to a given webhook_endpoint_id and event_id. This will either update an existing webhook subscription to the given event, or create a new one with the provided event types.

Event Types

Event types consist of a scope, locality, and event.

Scope

The public scope is always available, and the private scope is not currently available through the API.

Locality

This describes the source of the event, whether direct to the subscribed event, or indirect when the event occurs on one of the children of that event. For example all events under a fundraising event, or the campaigns under a team campaign.

Event

This describes the event that is going to be send via webhook. donation_updated will send donation events, and fact_updated will send event updates, for example if you need to get the totals raised by a given event.

List of supported event_types:

  • public:direct:auction_bid_amount_updated
  • public:direct:donation_updated
  • public:direct:fact_updated
  • public:indirect:donation_updated
  • public:indirect:fact_updated
Authorizations:
authorization
path Parameters
webhook_endpoint_id
required
string

Webhook Endpoint ID

event_id
required
string

Campaign/Team Campaign/Fundraising Event public_id

Request Body schema: application/json
optional

PUT request body to update a webhook subscription

event_types
required
Array of strings
Items Enum: "private:direct:auction_bid_amount_updated" "private:direct:donation_updated" "private:direct:fact_updated" "private:indirect:donation_updated" "private:indirect:fact_updated" "public:direct:auction_bid_amount_updated" "public:direct:donation_updated" "public:direct:fact_updated" "public:indirect:donation_updated" "public:indirect:fact_updated"

The list of event types this subscription should be subscribed to.

Responses

Request samples

Content type
application/json
{
  • "event_types": [
    ]
}

Response samples

Content type
application/json
{
  • "event_id": "51d3edd8-acbb-4818-a64a-4a86596dda41",
  • "event_types": [
    ],
  • "id": "daa10209-7a52-4e63-aa7c-32470ae4fdbd",
  • "inserted_at": "2025-09-09T18:27:02.645749Z",
  • "updated_at": "2025-09-09T18:27:02.645765Z",
  • "webhook_endpoint_id": "e704d55c-8a85-431a-9816-2d01292da666"
}

Creates or Updates a Webhook Subscription Deprecated

Use putWebhookSubscription instead. This operation was deprecated due to a spelling error.

Authorizations:
authorization
path Parameters
webhook_endpoint_id
required
string

Webhook Endpoint ID

event_id
required
string

Campaign/Team Campaign/Fundraising Event public_id

Request Body schema: application/json
optional

PUT request body to update a webhook subscription

event_types
required
Array of strings
Items Enum: "private:direct:auction_bid_amount_updated" "private:direct:donation_updated" "private:direct:fact_updated" "private:indirect:donation_updated" "private:indirect:fact_updated" "public:direct:auction_bid_amount_updated" "public:direct:donation_updated" "public:direct:fact_updated" "public:indirect:donation_updated" "public:indirect:fact_updated"

The list of event types this subscription should be subscribed to.

Responses

Request samples

Content type
application/json
{
  • "event_types": [
    ]
}

Response samples

Content type
application/json
{
  • "event_id": "51d3edd8-acbb-4818-a64a-4a86596dda41",
  • "event_types": [
    ],
  • "id": "daa10209-7a52-4e63-aa7c-32470ae4fdbd",
  • "inserted_at": "2025-09-09T18:27:02.645749Z",
  • "updated_at": "2025-09-09T18:27:02.645765Z",
  • "webhook_endpoint_id": "e704d55c-8a85-431a-9816-2d01292da666"
}

List Relay Keys by Webhook Relay ID

Returns Webhook Relay Keys for a Webhook Relay

Authorizations:
authorization
path Parameters
webhook_relay_id
required
string

Webhook Relay ID

query Parameters
after
string

Returns records after the given cursor

before
string

Returns records before the given cursor

limit
integer [ 1 .. 100 ]
Default: 10

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "metadata": {
    }
}

Creates a new Webhook Relay Key

Requires scope:webhooks:write

Creates a new Webhook Relay Key.

Authorizations:
authorization
path Parameters
webhook_relay_id
required
string

Webhook Relay ID

Request Body schema: application/json
optional

POST request body to create a webhook relay key

id
string or null

An Optional ID that you can use to lookup the Relay Key. If you do not pass one, we will generate an UUID for you.

metadata
string or null

An Optional string of metadata that will be associated with the relay key. Metadata will be stored, and sent to your webhook endpoint as is.

Responses

Request samples

Content type
application/json
{
  • "id": "internal_2Oycg8ksnPDz9ku2RhDuVuvEfmV",
  • "metadata": "Q3VzdG9tIE1ldGFkYXRhIFN0cmluZw=="
}

Response samples

Content type
application/json
{
  • "client_key": "3fee0b7d5aa2ba9727dab0409f9822aa9b6d1914a301ea39ae180750cb632c6a",
  • "donation": {
    },
  • "id": "ef53632b-7a48-42d2-ad04-d5c1031677d2",
  • "inserted_at": "2025-09-09T18:09:05.479939Z",
  • "metadata": "Q3VzdG9tIE1ldGFkYXRhIFN0cmluZw==",
  • "updated_at": "2025-09-09T18:09:05.482680Z",
  • "webhook_relay_id": "c784f8e4-9e2a-4b29-872b-6a0ef31345de"
}

Returns a Webhook Relay Key by ID

Returns a Webhook Relay Key by its ID

Authorizations:
authorization
path Parameters
webhook_relay_id
required
string

Webhook Relay ID

webhook_relay_key_id
required
string

Webhook Relay Key ID

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}