Create notification subscription
https://sandbox-api.akoya.com/notifications/{version}/subscriptions
Creates a notification subscription.
🛑 The service token should be used as the bearer token with this call.
When you trigger a test in our sandbox environment, you will see a sample of a webhook containing example values. The id in the POST request will be a subscription id for a valid sandbox subscription:
BASH
curl --location "https://sandbox-api.qa.akoya.com/notifications/v1/test" \
--header "Content-Type: application/json" \
--header "Authorization: ••••••" \
--data `{
"id": "51d61cf5-b48b-4bfc-b2c7-f7a637bcd99c"
}`Path Parameters
version*
stringdefault: v1version of endpoint.
v1
Body Params
category*
string
Category of Notification
MAINTENANCEtype*
string
Type of Notification
SERVICEcallbackUrl*
string
The URL to receive webhooks from Akoya. Must be HTTPS.
Example: https://abc.com/notification
effectiveDate
string
Effective date of notification
Example: 2021-07-15
callbackEmail
string
Optional. Captured for future implementation, which will be in an upcoming release.
Responses
200
OK
Response Body
category
Category of notification
string
type
Type of notification
string
callbackUrl
string
The URL to receive webhooks from Akoya. Must be HTTPS.
effectiveDate
string
Effective date of notification
callbackEmail
string
Optional. Captured for future implementation, which will be in an upcoming release.
subscriptionId
string
id
400
Input sent by client does not satisfy API specification
Response Body
object
code
string
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
debugMessage
string
Message used to debug the root cause of the error. Contents should not be used in consumer's business logic. Can change at any time and should only be used for consumer to communicate with the data provider about an issue. Provider can include an error GUID in message for their use.
401
Unauthorized to create a notification subscription
Response Body
object
code
string
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
debugMessage
string
Message used to debug the root cause of the error. Contents should not be used in consumer's business logic. Can change at any time and should only be used for consumer to communicate with the data provider about an issue. Provider can include an error GUID in message for their use.
405
Method Not Allowed
Response Body
object
code
string
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
debugMessage
string
Message used to debug the root cause of the error. Contents should not be used in consumer's business logic. Can change at any time and should only be used for consumer to communicate with the data provider about an issue. Provider can include an error GUID in message for their use.
429
Too Many Requests
Response Body
object
code
string
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
debugMessage
string
Message used to debug the root cause of the error. Contents should not be used in consumer's business logic. Can change at any time and should only be used for consumer to communicate with the data provider about an issue. Provider can include an error GUID in message for their use.
500
Catch all exception where request was not processed due to an internal outage/issue.
Response Body
object
code
string
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
debugMessage
string
Message used to debug the root cause of the error. Contents should not be used in consumer's business logic. Can change at any time and should only be used for consumer to communicate with the data provider about an issue. Provider can include an error GUID in message for their use.
501
FDX version not supported or implemented.
Response Body
object
code
string
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
debugMessage
string
Message used to debug the root cause of the error. Contents should not be used in consumer's business logic. Can change at any time and should only be used for consumer to communicate with the data provider about an issue. Provider can include an error GUID in message for their use.
503
System is down for maintenance
Response Body
object
code
string
Long term persistent identifier which can be used to trace error condition back to log information
message
string
End user displayable information which might help the customer diagnose an error
debugMessage
string
Message used to debug the root cause of the error. Contents should not be used in consumer's business logic. Can change at any time and should only be used for consumer to communicate with the data provider about an issue. Provider can include an error GUID in message for their use.
Try it
Authorization
const options = {
"method": "POST",
"headers": {
"accept": "application/json"
},
"body": JSON.stringify({
"category": "MAINTENANCE",
"type": "SERVICE",
"callbackUrl": ""
})
}};
fetch('https://sandbox-api.akoya.com/notifications/v1/subscriptions', options)
.then(response => response.json())
.catch(err => console.error(err));