JustGiving API

Uri /{apiKey}/v1/event/
Verb POST
Auth No

Creates an event on JustGiving allowing you to programatically create pages for events you manage. Currently, these events will not show up in the JustGiving event search, this functionality will expand in the future. Please try to prevent creating duplicate events, or duplicate existing events (don't create your own London Marathon event!)

Http

To request: https://api.justgiving.com/{apiKey}/v1/event/
Perform the following HTTP request:

POST /{apiKey}/v1/event/ HTTP/1.1
Host: api.justgiving.com
Content-type: application/json

Request Body

{
    "completionDate": "\/Date(1429947247499+0100)\/",
    "description": "Playing Mario for charity",
    "eventType": 8,
    "expiryDate": "\/Date(1429947247499+0100)\/",
    "id": 12356,
    "location": "My Living room",
    "name": "Playing Mario for 48 hours for charity",
    "startDate": "\/Date(1398584047499+0100)\/"
}

Parameters

name (String)
description (String)
id (Integer (32bit))
JustGiving EventId, ignored during requests to the RegisterEvent API.
completionDate (DateTime)
The date the event finishes
expiryDate (DateTime)
The date the event expires and will subsequently become unavailable on the site
startDate (DateTime)
The event start date
eventType (EventType)
Event names will be shown on fundraising pages for an event type of: Running_Marathons Treks, Walks, Cycling, Swimming, Triathlons, Parachuting_Skydives, OtherSportingEvents. Other event types will be correctly linked, but not visually represented on the page. Supported values: Running_Marathons, Treks, Walks, Cycling, Swimming, Birthday, Wedding, OtherCelebration, Christening, InMemory, Anniversaries, Triathlons, Parachuting_Skydives, OtherSportingEvents, NewYearsResolutions, Christmas, OtherPersonalChallenge, CharityAppeal, IndividualAppeal, CompanyAppeal, PersonalRunning_Marathons, PersonalTreks, PersonalWalks, PersonalCycling, PersonalSwimming, PersonalTriathlons, PersonalParachuting_Skydives
location (String)

HTTP Status Codes

  • 201 Created - Created

Response Examples

{
    "id": 12345,
    "next": {
        "rel": "https:\/\/api.justgiving.com\/{apiKey}\/v1\/event\/12345",
        "uri": "https:\/\/api.justgiving.com\/{apiKey}\/v1\/event\/12345",
        "type": "application\/xml"
    }
}
Next.rel (String)
Next.uri (String)
Next.type (String)
Error.id (String)
Error.desc (String)
id (Integer (32bit))

Comments