Update sponsor

The Update sponsor API allows event organizers and portal administrators to modify an existing sponsor record associated with a specific event in their Zoho Backstage portal. By passing the unique sponsor_id, along with the portal_id and event_id, you can update sponsor details such as company name, sponsorship tier, amount, currency, contact details, website URL, and description.

This endpoint is typically used when you want to:

  • Update sponsor company information

  • Modify sponsorship tier assignments

  • Change billing amounts or currency

  • Update sponsor contact details

  • Correct sponsor description or website URL

  • Maintain accurate sponsorship records

 

Header

Authorization: Zoho-oauthtoken {{access_token}}

 

OAuth Scope

zohobackstage.sponsor.UPDATE

 

Path Parameters

  • portal_id (Integer)
    The unique identifier of the Zoho Backstage portal in which the sponsor record exists. This ensures the update operation is scoped to the correct portal environment. For example, "portal_id": 31693662 specifies the portal where the sponsor resides.

  • event_id (Integer)
    The unique identifier of the event associated with the sponsor. Sponsors are always linked to a specific event. For example, "event_id": 5000000039057 specifies the event containing the sponsor.

  • sponsor_id (Integer)
    The unique identifier of the sponsor record that you want to update. This ID uniquely represents the sponsor within the event. For example, "sponsor_id": 5000000065011 identifies the sponsor record to be updated.

Payload Parameter

  • company_name (String)
    The updated company name of the sponsor. If provided, this value replaces the existing company name stored in the system. For example, "company_name": "Zylker" updates the sponsor’s company name.

Response Structure and Field Explanations

  • id (String)
    The unique system-generated identifier assigned to the sponsor record. This ID confirms which sponsor record has been updated. For example, "id": "2000000019015" represents the updated sponsor record.
  • sponsorship_type (String)
    The internal identifier of the sponsorship tier currently associated with the sponsor. If not modified in the payload, this value remains unchanged. For example, "sponsorship_type": "2000000018003" indicates the sponsor’s tier ID.
  • sponsorship_type_name (String)
    The display name of the sponsorship tier assigned to the sponsor. This corresponds to the sponsorship_type ID. For example, "sponsorship_type_name": "GOLD" indicates that the sponsor belongs to the Gold category.
  • company_name (String)
    The official name of the sponsor organization stored in the system after the update operation. For example, "company_name": "Zylker" represents the updated company name in the system.
  • amount (Integer)
    The sponsorship amount associated with the sponsor. If not modified in the request payload, this value remains unchanged. For example, "amount": 499 indicates the sponsorship fee.
  • currency_code (String)
    The ISO currency code associated with the sponsorship amount. For example, "currency_code": "AUD" indicates Australian Dollars.
  • index (Integer)
    The display order of the sponsor in sponsor listings. This value determines the sponsor’s placement on the event website or sponsor section. For example, "index": 0 indicates first position.
  • website_url (String)
    The sponsor’s official website URL stored in the system. For example, "website_url": "www.zylker.com" provides the sponsor’s website link.
  • contact (Object)
    An object containing details of the sponsor’s primary contact person.
    • first_name (String)
      The first name of the sponsor’s contact person. For example, "first_name": "Sam" identifies the contact’s first name.
    • last_name (String)
      The last name of the sponsor’s contact person. For example, "last_name": "Peter" identifies the contact’s last name.
    • email (String)
      The email address of the sponsor’s contact person. For example, "email": "sam@zylker.com" specifies the contact’s email address.
    • telephone (String)
      The telephone number of the sponsor’s contact person. For example, "telephone": "9988776655" specifies the contact’s phone number.
  • language (String)
    The language preference associated with the sponsor record. For example, "language": "en" indicates English as the default language.
  • description (String)
    The description associated with the sponsor record. This text may appear alongside the sponsor listing on the event website. For example, "description": "Leading global provider of cloud software." provides a summary of the sponsor.
  • created_by (Object)
    An object containing details of the user who originally created the sponsor record.
    • id (String)
      The unique identifier of the user who created the sponsor record. For example, "id": "2000000000001".
    • email (String)
      The email address of the user who created the sponsor record. For example, "email": "john@example.com".
    • first_name (String)
      The display name of the creator. For example, "first_name": "John".
    • company (String | null)
      The company associated with the creator. This value may be null if not defined.
    • designation (String | null)
      The designation of the creator. This value may be null if not defined.
  • created_time (String)
    The timestamp indicating when the sponsor record was originally created. This value is returned in ISO 8601 UTC format. For example, "created_time": "2026-03-21T05:55:16Z".
  • last_modified_by (Object)
    An object containing details of the user who last modified the sponsor record.
    • id (String)
      The unique identifier of the modifying user. For example, "id": "2000000000001".
    • email (String)
      The email address of the user who last modified the sponsor record. For example, "email": "john@example.com".
    • first_name (String)
      The display name of the modifying user. For example, "first_name": "John".
    • company (String | null)
      The company associated with the modifying user. This value may be null if not defined.
    • designation (String | null)
      The designation of the modifying user. This value may be null if not defined.
  • last_modified_time (String)
    The timestamp indicating when the sponsor record was last modified. This value is returned in ISO 8601 UTC format. For example, "last_modified_time": "2026-03-21T05:55:16Z".

URL

Copied/backstage/v3/portals/{portal_id}/events/{event_id}/sponsors/{sponsor_id}

Example

Copied/backstage/v3/portals/31693662/events/5000000039057/sponsors/5000000065011

Sample Payload

Copied{
   "company_name": "Zylker"
}

Sample Response

Copied{
    "id": "2000000019015",
    "sponsorship_type": "2000000018003",
    "sponsorship_type_name": "GOLD",
    "company_name": "Zylker",
    "amount": 499,
    "currency_code": "AUD",
    "index": 0,
    "website_url": "www.zylker.com",
    "contact": {
        "first_name": "Sam",
        "last_name": "Peter",
        "email": "sam@zylker.com",
        "telephone": "9988776655"
    },
    "language": "en",
    "description": "Leading global provider of cloud software.",
    "created_by": {
        "id": "2000000000001",
        "email": "john@example.com",
        "first_name": "John",
        "company": null,
        "designation": null
    },
    "created_time": "2026-03-21T05:55:16Z",
    "last_modified_by": {
        "id": "2000000000001",
        "email": "John@example.com",
        "first_name": "John",
        "company": null,
        "designation": null
    },
    "last_modified_time": "2026-03-21T05:55:16Z"
}