WePay logo
      Nothing Found

Update a notification preference

post/notification_preferences/{id}

The POST /notification_preferences/{id} call allows your platform to update a notification preference. Notification preferences allow your platform to subscribe to notifications based on an event topic.

SecurityappIdAuth and appTokenAuth
Request
path Parameters
id
required
string [ 1 .. 255 ] characters

ID of the notification preference, generated by WePay when the notification preference is created.

header Parameters
Api-Version
required
string
Example: 3.0
Content-Type
required
stringapplication/json
Example: application/json
Unique-Key
string
Request Body schema: application/json
callback_uri
string <= 2063 characters ^https?://.+$

A valid, publicly available URL that works as an endpoint for HTTPS requests. This cannot be a local host. If for notification preferences, must be HTTPS.

Responses
200
Response Schema: application/json
id
required
string
resource
required
string

Helps organize information by identifying the resource type of the object data.

Value: Description
notification_preferences
path
required
string
create_time
required
integer <int64> >= 0
topic
required
string
callback_uri
required
string
status
required
string

Status of the notification preference. Possible values are: active, unreachable, deleted.

Enum: Description
active

The notification preference is active and ready to be used.

deleted

The notification preference has already been deleted.

… 1 more
api_version
string
object

This owner resource and owner path of the object.

400

INVALID_PARAMS

403

NOT_AUTHORIZED

500

UNEXPECTED_ERROR

Request samples
application/json
{}
Response samples
application/json
{
  • "callback_uri": "https://example.com/disputes_created",
  • "create_time": 1509407823974,
  • "id": "9164a672-8128-4163-8f66-04a9172d2911",
  • "owner": {
    • "id": "74582",
    • "path": null,
    • "resource": "applications"
    },
  • "path": "/notification_preferences/9164a672-8128-4163-8f66-04a9172d2911",
  • "resource": "notification_preferences",
  • "status": "active",
  • "topic": "disputes.created",
  • "api_version": "3.0"
}