Webhooks
Download SpecAll webhook related paths.
oauth-client-credentials
Required Scopes:
webhooks:read
webhooks:admin
All Scopes
-
account_liquidations:admin
· Trigger/read/cancel accounts liquidations -
account_liquidations:read
· Read accounts liquidations -
account_returns:read
· Read accounts returns -
accounts:admin
· Create/update/delete accounts and account groups -
accounts:read
· Read accounts and account groups -
checks:admin
· Create checks -
checks:read
· Read checks -
credit_fundings:read
· Credit Fundings read operations -
fees:admin
· Create and read fee operations -
fees:read
· Read fee operations -
instruments:read
· Read instruments -
mandates:admin
· Create/update/delete mandates -
mandates:read
· Read mandates -
orders:admin
· Create/update/delete orders -
orders:read
· Read orders -
payments:admin
· Payins and withdrawal operations -
payments:read
· Payins and withdrawal read operations -
portfolios:admin
· Modify portfolios -
portfolios:read
· Read portfolios -
positions:read
· Read positions -
prices:read
· Read instrument prices -
reference_accounts:admin
· Create/update/delete reference accounts -
reference_accounts:read
· Read reference accounts -
reports:admin
· Create reports -
reports:read
· Read reports -
savings_plans:admin
· Create/read savings plans -
savings_plans:read
· Read savings plans -
taxes:admin
· Modify tax residencies -
taxes:read
· Read tax residencies -
topups:admin
· Topups operations -
topups:read
· Topups read operations -
transactions:read
· Read cash and securities transactions -
users:admin
· Create/update/delete users -
users:read
· Read users -
valuations:read
· Read valuations -
virtual_cash_balances:admin
· Virtual cash balances -
webhooks:admin
· Create/update/delete webhooks -
webhooks:read
· Read webhooks
- Flow Type:
- Client Credentials
- Token URL:
- https://sandbox.upvest.co/auth/token
upvest-client-id
string
uuid
required
Tenant Client ID
- Example
- "ebabcf4d-61c3-4942-875c-e265a7c2d062"
authorization
string
^Bearer [a-zA-Z0-9\-\._~+/]*=*
required
Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750
- Example
- "Bearer c2VjcmV0Cg=="
signature
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header
signature-input
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he
upvest-api-version
string
Upvest API version (Note: Do not include quotation marks)
- Default
- "1"
- Enum
-
- 1
- Example
- 1
Response
JWKS signing public keys
Unauthorized. The caller has not been authenticated.
Forbidden. The caller has been authenticated but is not allowed to take the requested action.
Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
Internal Server Error. The service encountered an unexpected error.
Service Unavailable. The service handling for this request cannot be reached at this time.
Gateway Timeout. The service gateway has reached its internal timeout.
keys
array[object]
required
List of verification keys
object
kid
string
uuid
Key ID
kty
string
Cryptographic algorithm family used with the key.
- EC -
- Default
- "EC"
- Enum
-
- EC
crv
string
Elliptic curve family.
- P-521 -
- Default
- "P-521"
- Enum
-
- P-521
x
string
Curve parameter
y
string
Curve parameter
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
oauth-client-credentials
Required Scopes:
webhooks:read
webhooks:admin
All Scopes
-
account_liquidations:admin
· Trigger/read/cancel accounts liquidations -
account_liquidations:read
· Read accounts liquidations -
account_returns:read
· Read accounts returns -
accounts:admin
· Create/update/delete accounts and account groups -
accounts:read
· Read accounts and account groups -
checks:admin
· Create checks -
checks:read
· Read checks -
credit_fundings:read
· Credit Fundings read operations -
fees:admin
· Create and read fee operations -
fees:read
· Read fee operations -
instruments:read
· Read instruments -
mandates:admin
· Create/update/delete mandates -
mandates:read
· Read mandates -
orders:admin
· Create/update/delete orders -
orders:read
· Read orders -
payments:admin
· Payins and withdrawal operations -
payments:read
· Payins and withdrawal read operations -
portfolios:admin
· Modify portfolios -
portfolios:read
· Read portfolios -
positions:read
· Read positions -
prices:read
· Read instrument prices -
reference_accounts:admin
· Create/update/delete reference accounts -
reference_accounts:read
· Read reference accounts -
reports:admin
· Create reports -
reports:read
· Read reports -
savings_plans:admin
· Create/read savings plans -
savings_plans:read
· Read savings plans -
taxes:admin
· Modify tax residencies -
taxes:read
· Read tax residencies -
topups:admin
· Topups operations -
topups:read
· Topups read operations -
transactions:read
· Read cash and securities transactions -
users:admin
· Create/update/delete users -
users:read
· Read users -
valuations:read
· Read valuations -
virtual_cash_balances:admin
· Virtual cash balances -
webhooks:admin
· Create/update/delete webhooks -
webhooks:read
· Read webhooks
- Flow Type:
- Client Credentials
- Token URL:
- https://sandbox.upvest.co/auth/token
upvest-client-id
string
uuid
required
Tenant Client ID
- Example
- "ebabcf4d-61c3-4942-875c-e265a7c2d062"
authorization
string
^Bearer [a-zA-Z0-9\-\._~+/]*=*
required
Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750
- Example
- "Bearer c2VjcmV0Cg=="
signature
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header
signature-input
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he
upvest-api-version
string
Upvest API version (Note: Do not include quotation marks)
- Default
- "1"
- Enum
-
- 1
- Example
- 1
sort
string
Sort the result by created_at
, updated_at
, title
, url
, or enabled
.
- Default
- "created_at"
- Enum
-
- created_at
- updated_at
- title
- url
- enabled
order
string
Sort order of the result list if the sort
parameter is specified. Use ASC
for ascending or DESC
for descending sort order.
- Default
- "ASC"
- Enum
-
- ASC
- DESC
offset
int
i32
Use the offset
argument to specify where in the list of results to start when returning items for a particular query.
- Min
- 0
limit
int
i32
Use the limit
argument to specify the maximum number of items returned.
- Default
- 100
- Min
- 0
- Max
- 1000
Response
An object with a data property that contains an array of webhook subscription objects.
Bad Request. The incoming request had a malformed parameter/object.
Unauthorized. The caller has not been authenticated.
Forbidden. The caller has been authenticated but is not allowed to take the requested action.
Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
Internal Server Error. The service encountered an unexpected error.
Service Unavailable. The service handling for this request cannot be reached at this time.
Gateway Timeout. The service gateway has reached its internal timeout.
meta
object (meta)
required
offset
int
required
Amount of resource to offset in the response.
limit
int
required
Total limit of the response.
count
int
required
Count of the resources returned in the response.
total_count
int
required
Total count of all the resources.
sort
string
The field that the list is sorted by.
order
string
The ordering of the response.
- ASC - Ascending order
- DESC - Descending order
- Enum
-
- ASC
- DESC
data
array[object (Webhook)]
required
Webhook
object (Webhook)
id
string
uuid
required
Webhook unique identifier.
created_at
string
date-time
required
Date and time when the resource was created. RFC 3339-5, ISO8601 UTC
updated_at
string
date-time
required
Date and time when the resource was last updated. RFC 3339-5, ISO8601 UTC
title
string
^[a-zA-Z0-9 ()\[\]{}.-]{1,32}$
required
Title of the webhook for use on tenant side.
url
string
url
required
The callback URL to be called by the webhook.
- Max Length
- 1000
enabled
boolean
required
Enable/disable webhook.
type
array[string]
required
What kind of events to be sent by the webhook.
- Default
- ["ALL"]
string
- Enum
-
- ALL
- USER
- USER_CHECK
- ORDER
- ORDER_CANCELLATION
- EXECUTION
- POSITION
- CASH_BALANCE
- ACCOUNT
- ACCOUNT_GROUP
- REPORT
- TREASURY_REPORT
- DIRECT_DEBIT
- WITHDRAWAL
- PORTFOLIO
- PORTFOLIO_ALLOCATION
- PORTFOLIO_ORDER
- CORPORATE_ACTION
- ACCOUNT_VALUATION
- INTRADAY_ACCOUNT_VALUATION
- CASH_TRANSACTION
- SECURITY_TRANSACTION
- ACCOUNT_LIQUIDATION
- ACCOUNT_RETURNS
- VIRTUAL_CASH_INCREASE
- VIRTUAL_CASH_DECREASE
- FEE_COLLECTION
- SAVINGS_PLAN
- SAVINGS_PLAN_EXECUTION
config
object (config)
required
Configuration of webhook packages collection.
delay
string
^[1-9][0-9]?[sm]$
Maximum time of package collection.
max_package_size
int
Maximum package size (bytes)
- Min
- 100
- Max
- 1048576
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
oauth-client-credentials
Required Scopes:
webhooks:admin
All Scopes
-
account_liquidations:admin
· Trigger/read/cancel accounts liquidations -
account_liquidations:read
· Read accounts liquidations -
account_returns:read
· Read accounts returns -
accounts:admin
· Create/update/delete accounts and account groups -
accounts:read
· Read accounts and account groups -
checks:admin
· Create checks -
checks:read
· Read checks -
credit_fundings:read
· Credit Fundings read operations -
fees:admin
· Create and read fee operations -
fees:read
· Read fee operations -
instruments:read
· Read instruments -
mandates:admin
· Create/update/delete mandates -
mandates:read
· Read mandates -
orders:admin
· Create/update/delete orders -
orders:read
· Read orders -
payments:admin
· Payins and withdrawal operations -
payments:read
· Payins and withdrawal read operations -
portfolios:admin
· Modify portfolios -
portfolios:read
· Read portfolios -
positions:read
· Read positions -
prices:read
· Read instrument prices -
reference_accounts:admin
· Create/update/delete reference accounts -
reference_accounts:read
· Read reference accounts -
reports:admin
· Create reports -
reports:read
· Read reports -
savings_plans:admin
· Create/read savings plans -
savings_plans:read
· Read savings plans -
taxes:admin
· Modify tax residencies -
taxes:read
· Read tax residencies -
topups:admin
· Topups operations -
topups:read
· Topups read operations -
transactions:read
· Read cash and securities transactions -
users:admin
· Create/update/delete users -
users:read
· Read users -
valuations:read
· Read valuations -
virtual_cash_balances:admin
· Virtual cash balances -
webhooks:admin
· Create/update/delete webhooks -
webhooks:read
· Read webhooks
- Flow Type:
- Client Credentials
- Token URL:
- https://sandbox.upvest.co/auth/token
upvest-client-id
string
uuid
required
Tenant Client ID
- Example
- "ebabcf4d-61c3-4942-875c-e265a7c2d062"
authorization
string
^Bearer [a-zA-Z0-9\-\._~+/]*=*
required
Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750
- Example
- "Bearer c2VjcmV0Cg=="
signature
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header
signature-input
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he
upvest-api-version
string
Upvest API version (Note: Do not include quotation marks)
- Default
- "1"
- Enum
-
- 1
- Example
- 1
title
string
^[a-zA-Z0-9 ()\[\]{}.-]{1,32}$
required
Title of the webhook for use on tenant side.
url
string
url
required
The callback URL to be called by the webhook.
- Max Length
- 1000
type
array[string]
What kind of events to be sent by the webhook.
- Default
- ["ALL"]
string
- Enum
-
- ALL
- USER
- USER_CHECK
- ORDER
- ORDER_CANCELLATION
- EXECUTION
- POSITION
- CASH_BALANCE
- ACCOUNT
- ACCOUNT_GROUP
- REPORT
- TREASURY_REPORT
- DIRECT_DEBIT
- WITHDRAWAL
- PORTFOLIO
- PORTFOLIO_ALLOCATION
- PORTFOLIO_ORDER
- CORPORATE_ACTION
- ACCOUNT_VALUATION
- INTRADAY_ACCOUNT_VALUATION
- CASH_TRANSACTION
- SECURITY_TRANSACTION
- ACCOUNT_LIQUIDATION
- ACCOUNT_RETURNS
- VIRTUAL_CASH_INCREASE
- VIRTUAL_CASH_DECREASE
- FEE_COLLECTION
- SAVINGS_PLAN
- SAVINGS_PLAN_EXECUTION
config
object (config)
Configuration of webhook packages collection.
delay
string
^[1-9][0-9]?[sm]$
Maximum time of package collection.
max_package_size
int
Maximum package size (bytes)
- Min
- 100
- Max
- 1048576
Request
Response
Returns a webhook subscription object if a valid webhook subscription object ID was provided.
Bad Request. The incoming request had a malformed parameter/object.
Unauthorized. The caller has not been authenticated.
Forbidden. The caller has been authenticated but is not allowed to take the requested action.
Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
Internal Server Error. The service encountered an unexpected error.
Service Unavailable. The service handling for this request cannot be reached at this time.
Gateway Timeout. The service gateway has reached its internal timeout.
id
string
uuid
required
Webhook unique identifier.
created_at
string
date-time
required
Date and time when the resource was created. RFC 3339-5, ISO8601 UTC
updated_at
string
date-time
required
Date and time when the resource was last updated. RFC 3339-5, ISO8601 UTC
title
string
^[a-zA-Z0-9 ()\[\]{}.-]{1,32}$
required
Title of the webhook for use on tenant side.
url
string
url
required
The callback URL to be called by the webhook.
- Max Length
- 1000
enabled
boolean
required
Enable/disable webhook.
type
array[string]
required
What kind of events to be sent by the webhook.
- Default
- ["ALL"]
string
- Enum
-
- ALL
- USER
- USER_CHECK
- ORDER
- ORDER_CANCELLATION
- EXECUTION
- POSITION
- CASH_BALANCE
- ACCOUNT
- ACCOUNT_GROUP
- REPORT
- TREASURY_REPORT
- DIRECT_DEBIT
- WITHDRAWAL
- PORTFOLIO
- PORTFOLIO_ALLOCATION
- PORTFOLIO_ORDER
- CORPORATE_ACTION
- ACCOUNT_VALUATION
- INTRADAY_ACCOUNT_VALUATION
- CASH_TRANSACTION
- SECURITY_TRANSACTION
- ACCOUNT_LIQUIDATION
- ACCOUNT_RETURNS
- VIRTUAL_CASH_INCREASE
- VIRTUAL_CASH_DECREASE
- FEE_COLLECTION
- SAVINGS_PLAN
- SAVINGS_PLAN_EXECUTION
config
object (config)
required
Configuration of webhook packages collection.
delay
string
^[1-9][0-9]?[sm]$
Maximum time of package collection.
max_package_size
int
Maximum package size (bytes)
- Min
- 100
- Max
- 1048576
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
oauth-client-credentials
Required Scopes:
webhooks:read
webhooks:admin
All Scopes
-
account_liquidations:admin
· Trigger/read/cancel accounts liquidations -
account_liquidations:read
· Read accounts liquidations -
account_returns:read
· Read accounts returns -
accounts:admin
· Create/update/delete accounts and account groups -
accounts:read
· Read accounts and account groups -
checks:admin
· Create checks -
checks:read
· Read checks -
credit_fundings:read
· Credit Fundings read operations -
fees:admin
· Create and read fee operations -
fees:read
· Read fee operations -
instruments:read
· Read instruments -
mandates:admin
· Create/update/delete mandates -
mandates:read
· Read mandates -
orders:admin
· Create/update/delete orders -
orders:read
· Read orders -
payments:admin
· Payins and withdrawal operations -
payments:read
· Payins and withdrawal read operations -
portfolios:admin
· Modify portfolios -
portfolios:read
· Read portfolios -
positions:read
· Read positions -
prices:read
· Read instrument prices -
reference_accounts:admin
· Create/update/delete reference accounts -
reference_accounts:read
· Read reference accounts -
reports:admin
· Create reports -
reports:read
· Read reports -
savings_plans:admin
· Create/read savings plans -
savings_plans:read
· Read savings plans -
taxes:admin
· Modify tax residencies -
taxes:read
· Read tax residencies -
topups:admin
· Topups operations -
topups:read
· Topups read operations -
transactions:read
· Read cash and securities transactions -
users:admin
· Create/update/delete users -
users:read
· Read users -
valuations:read
· Read valuations -
virtual_cash_balances:admin
· Virtual cash balances -
webhooks:admin
· Create/update/delete webhooks -
webhooks:read
· Read webhooks
- Flow Type:
- Client Credentials
- Token URL:
- https://sandbox.upvest.co/auth/token
upvest-client-id
string
uuid
required
Tenant Client ID
- Example
- "ebabcf4d-61c3-4942-875c-e265a7c2d062"
authorization
string
^Bearer [a-zA-Z0-9\-\._~+/]*=*
required
Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750
- Example
- "Bearer c2VjcmV0Cg=="
signature
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header
signature-input
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he
upvest-api-version
string
Upvest API version (Note: Do not include quotation marks)
- Default
- "1"
- Enum
-
- 1
- Example
- 1
webhook_id
string
uuid
required
Webhook identifier
Response
Returns a webhook subscription object if a valid webhook subscription object ID was provided.
Unauthorized. The caller has not been authenticated.
Forbidden. The caller has been authenticated but is not allowed to take the requested action.
Not Found. The requested resource could not be found.
Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
Internal Server Error. The service encountered an unexpected error.
Service Unavailable. The service handling for this request cannot be reached at this time.
Gateway Timeout. The service gateway has reached its internal timeout.
id
string
uuid
required
Webhook unique identifier.
created_at
string
date-time
required
Date and time when the resource was created. RFC 3339-5, ISO8601 UTC
updated_at
string
date-time
required
Date and time when the resource was last updated. RFC 3339-5, ISO8601 UTC
title
string
^[a-zA-Z0-9 ()\[\]{}.-]{1,32}$
required
Title of the webhook for use on tenant side.
url
string
url
required
The callback URL to be called by the webhook.
- Max Length
- 1000
enabled
boolean
required
Enable/disable webhook.
type
array[string]
required
What kind of events to be sent by the webhook.
- Default
- ["ALL"]
string
- Enum
-
- ALL
- USER
- USER_CHECK
- ORDER
- ORDER_CANCELLATION
- EXECUTION
- POSITION
- CASH_BALANCE
- ACCOUNT
- ACCOUNT_GROUP
- REPORT
- TREASURY_REPORT
- DIRECT_DEBIT
- WITHDRAWAL
- PORTFOLIO
- PORTFOLIO_ALLOCATION
- PORTFOLIO_ORDER
- CORPORATE_ACTION
- ACCOUNT_VALUATION
- INTRADAY_ACCOUNT_VALUATION
- CASH_TRANSACTION
- SECURITY_TRANSACTION
- ACCOUNT_LIQUIDATION
- ACCOUNT_RETURNS
- VIRTUAL_CASH_INCREASE
- VIRTUAL_CASH_DECREASE
- FEE_COLLECTION
- SAVINGS_PLAN
- SAVINGS_PLAN_EXECUTION
config
object (config)
required
Configuration of webhook packages collection.
delay
string
^[1-9][0-9]?[sm]$
Maximum time of package collection.
max_package_size
int
Maximum package size (bytes)
- Min
- 100
- Max
- 1048576
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
oauth-client-credentials
Required Scopes:
webhooks:admin
All Scopes
-
account_liquidations:admin
· Trigger/read/cancel accounts liquidations -
account_liquidations:read
· Read accounts liquidations -
account_returns:read
· Read accounts returns -
accounts:admin
· Create/update/delete accounts and account groups -
accounts:read
· Read accounts and account groups -
checks:admin
· Create checks -
checks:read
· Read checks -
credit_fundings:read
· Credit Fundings read operations -
fees:admin
· Create and read fee operations -
fees:read
· Read fee operations -
instruments:read
· Read instruments -
mandates:admin
· Create/update/delete mandates -
mandates:read
· Read mandates -
orders:admin
· Create/update/delete orders -
orders:read
· Read orders -
payments:admin
· Payins and withdrawal operations -
payments:read
· Payins and withdrawal read operations -
portfolios:admin
· Modify portfolios -
portfolios:read
· Read portfolios -
positions:read
· Read positions -
prices:read
· Read instrument prices -
reference_accounts:admin
· Create/update/delete reference accounts -
reference_accounts:read
· Read reference accounts -
reports:admin
· Create reports -
reports:read
· Read reports -
savings_plans:admin
· Create/read savings plans -
savings_plans:read
· Read savings plans -
taxes:admin
· Modify tax residencies -
taxes:read
· Read tax residencies -
topups:admin
· Topups operations -
topups:read
· Topups read operations -
transactions:read
· Read cash and securities transactions -
users:admin
· Create/update/delete users -
users:read
· Read users -
valuations:read
· Read valuations -
virtual_cash_balances:admin
· Virtual cash balances -
webhooks:admin
· Create/update/delete webhooks -
webhooks:read
· Read webhooks
- Flow Type:
- Client Credentials
- Token URL:
- https://sandbox.upvest.co/auth/token
upvest-client-id
string
uuid
required
Tenant Client ID
- Example
- "ebabcf4d-61c3-4942-875c-e265a7c2d062"
authorization
string
^Bearer [a-zA-Z0-9\-\._~+/]*=*
required
Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750
- Example
- "Bearer c2VjcmV0Cg=="
signature
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header
signature-input
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he
upvest-api-version
string
Upvest API version (Note: Do not include quotation marks)
- Default
- "1"
- Enum
-
- 1
- Example
- 1
webhook_id
string
uuid
required
Webhook identifier
Response
Request has been processed successfully.
Empty response
Unauthorized. The caller has not been authenticated.
Forbidden. The caller has been authenticated but is not allowed to take the requested action.
Not Found. The requested resource could not be found.
Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
Internal Server Error. The service encountered an unexpected error.
Service Unavailable. The service handling for this request cannot be reached at this time.
Gateway Timeout. The service gateway has reached its internal timeout.
No schema
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
oauth-client-credentials
Required Scopes:
webhooks:admin
All Scopes
-
account_liquidations:admin
· Trigger/read/cancel accounts liquidations -
account_liquidations:read
· Read accounts liquidations -
account_returns:read
· Read accounts returns -
accounts:admin
· Create/update/delete accounts and account groups -
accounts:read
· Read accounts and account groups -
checks:admin
· Create checks -
checks:read
· Read checks -
credit_fundings:read
· Credit Fundings read operations -
fees:admin
· Create and read fee operations -
fees:read
· Read fee operations -
instruments:read
· Read instruments -
mandates:admin
· Create/update/delete mandates -
mandates:read
· Read mandates -
orders:admin
· Create/update/delete orders -
orders:read
· Read orders -
payments:admin
· Payins and withdrawal operations -
payments:read
· Payins and withdrawal read operations -
portfolios:admin
· Modify portfolios -
portfolios:read
· Read portfolios -
positions:read
· Read positions -
prices:read
· Read instrument prices -
reference_accounts:admin
· Create/update/delete reference accounts -
reference_accounts:read
· Read reference accounts -
reports:admin
· Create reports -
reports:read
· Read reports -
savings_plans:admin
· Create/read savings plans -
savings_plans:read
· Read savings plans -
taxes:admin
· Modify tax residencies -
taxes:read
· Read tax residencies -
topups:admin
· Topups operations -
topups:read
· Topups read operations -
transactions:read
· Read cash and securities transactions -
users:admin
· Create/update/delete users -
users:read
· Read users -
valuations:read
· Read valuations -
virtual_cash_balances:admin
· Virtual cash balances -
webhooks:admin
· Create/update/delete webhooks -
webhooks:read
· Read webhooks
- Flow Type:
- Client Credentials
- Token URL:
- https://sandbox.upvest.co/auth/token
upvest-client-id
string
uuid
required
Tenant Client ID
- Example
- "ebabcf4d-61c3-4942-875c-e265a7c2d062"
authorization
string
^Bearer [a-zA-Z0-9\-\._~+/]*=*
required
Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750
- Example
- "Bearer c2VjcmV0Cg=="
signature
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header
signature-input
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he
upvest-api-version
string
Upvest API version (Note: Do not include quotation marks)
- Default
- "1"
- Enum
-
- 1
- Example
- 1
webhook_id
string
uuid
required
Webhook identifier
title
string
^[a-zA-Z0-9 ()\[\]{}.-]{1,32}$
Title of the webhook for use on tenant side.
url
string
url
The callback URL to be called by the webhook.
- Max Length
- 1000
enabled
boolean
Enable/disable webhook.
type
array[string]
What kind of events to be sent by the webhook.
- Default
- ["ALL"]
string
- Enum
-
- ALL
- USER
- USER_CHECK
- ORDER
- ORDER_CANCELLATION
- EXECUTION
- POSITION
- CASH_BALANCE
- ACCOUNT
- ACCOUNT_GROUP
- REPORT
- TREASURY_REPORT
- DIRECT_DEBIT
- WITHDRAWAL
- PORTFOLIO
- PORTFOLIO_ALLOCATION
- PORTFOLIO_ORDER
- CORPORATE_ACTION
- ACCOUNT_VALUATION
- INTRADAY_ACCOUNT_VALUATION
- CASH_TRANSACTION
- SECURITY_TRANSACTION
- ACCOUNT_LIQUIDATION
- ACCOUNT_RETURNS
- VIRTUAL_CASH_INCREASE
- VIRTUAL_CASH_DECREASE
- FEE_COLLECTION
- SAVINGS_PLAN
- SAVINGS_PLAN_EXECUTION
config
object (config)
Configuration of webhook packages collection.
delay
string
^[1-9][0-9]?[sm]$
Maximum time of package collection.
max_package_size
int
Maximum package size (bytes)
- Min
- 100
- Max
- 1048576
Request
Response
Returns a webhook subscription object if a valid webhook subscription object ID was provided.
Bad Request. The incoming request had a malformed parameter/object.
Unauthorized. The caller has not been authenticated.
Forbidden. The caller has been authenticated but is not allowed to take the requested action.
Not Found. The requested resource could not be found.
Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
Internal Server Error. The service encountered an unexpected error.
Service Unavailable. The service handling for this request cannot be reached at this time.
Gateway Timeout. The service gateway has reached its internal timeout.
id
string
uuid
required
Webhook unique identifier.
created_at
string
date-time
required
Date and time when the resource was created. RFC 3339-5, ISO8601 UTC
updated_at
string
date-time
required
Date and time when the resource was last updated. RFC 3339-5, ISO8601 UTC
title
string
^[a-zA-Z0-9 ()\[\]{}.-]{1,32}$
required
Title of the webhook for use on tenant side.
url
string
url
required
The callback URL to be called by the webhook.
- Max Length
- 1000
enabled
boolean
required
Enable/disable webhook.
type
array[string]
required
What kind of events to be sent by the webhook.
- Default
- ["ALL"]
string
- Enum
-
- ALL
- USER
- USER_CHECK
- ORDER
- ORDER_CANCELLATION
- EXECUTION
- POSITION
- CASH_BALANCE
- ACCOUNT
- ACCOUNT_GROUP
- REPORT
- TREASURY_REPORT
- DIRECT_DEBIT
- WITHDRAWAL
- PORTFOLIO
- PORTFOLIO_ALLOCATION
- PORTFOLIO_ORDER
- CORPORATE_ACTION
- ACCOUNT_VALUATION
- INTRADAY_ACCOUNT_VALUATION
- CASH_TRANSACTION
- SECURITY_TRANSACTION
- ACCOUNT_LIQUIDATION
- ACCOUNT_RETURNS
- VIRTUAL_CASH_INCREASE
- VIRTUAL_CASH_DECREASE
- FEE_COLLECTION
- SAVINGS_PLAN
- SAVINGS_PLAN_EXECUTION
config
object (config)
required
Configuration of webhook packages collection.
delay
string
^[1-9][0-9]?[sm]$
Maximum time of package collection.
max_package_size
int
Maximum package size (bytes)
- Min
- 100
- Max
- 1048576
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
oauth-client-credentials
Required Scopes:
webhooks:admin
All Scopes
-
account_liquidations:admin
· Trigger/read/cancel accounts liquidations -
account_liquidations:read
· Read accounts liquidations -
account_returns:read
· Read accounts returns -
accounts:admin
· Create/update/delete accounts and account groups -
accounts:read
· Read accounts and account groups -
checks:admin
· Create checks -
checks:read
· Read checks -
credit_fundings:read
· Credit Fundings read operations -
fees:admin
· Create and read fee operations -
fees:read
· Read fee operations -
instruments:read
· Read instruments -
mandates:admin
· Create/update/delete mandates -
mandates:read
· Read mandates -
orders:admin
· Create/update/delete orders -
orders:read
· Read orders -
payments:admin
· Payins and withdrawal operations -
payments:read
· Payins and withdrawal read operations -
portfolios:admin
· Modify portfolios -
portfolios:read
· Read portfolios -
positions:read
· Read positions -
prices:read
· Read instrument prices -
reference_accounts:admin
· Create/update/delete reference accounts -
reference_accounts:read
· Read reference accounts -
reports:admin
· Create reports -
reports:read
· Read reports -
savings_plans:admin
· Create/read savings plans -
savings_plans:read
· Read savings plans -
taxes:admin
· Modify tax residencies -
taxes:read
· Read tax residencies -
topups:admin
· Topups operations -
topups:read
· Topups read operations -
transactions:read
· Read cash and securities transactions -
users:admin
· Create/update/delete users -
users:read
· Read users -
valuations:read
· Read valuations -
virtual_cash_balances:admin
· Virtual cash balances -
webhooks:admin
· Create/update/delete webhooks -
webhooks:read
· Read webhooks
- Flow Type:
- Client Credentials
- Token URL:
- https://sandbox.upvest.co/auth/token
upvest-client-id
string
uuid
required
Tenant Client ID
- Example
- "ebabcf4d-61c3-4942-875c-e265a7c2d062"
authorization
string
^Bearer [a-zA-Z0-9\-\._~+/]*=*
required
Bearer (access) token from the OAuth flow with correct scopes. https://datatracker.ietf.org/doc/html/rfc6750
- Example
- "Bearer c2VjcmV0Cg=="
signature
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-http-header
signature-input
string
required
https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures-01.html#name-the-signature-input-http-he
upvest-api-version
string
Upvest API version (Note: Do not include quotation marks)
- Default
- "1"
- Enum
-
- 1
- Example
- 1
webhook_id
string
uuid
required
Webhook identifier
Response
The request has been successfully accepted and will be processed asynchronously.
Empty response
Unauthorized. The caller has not been authenticated.
Forbidden. The caller has been authenticated but is not allowed to take the requested action.
Not Found. The requested resource could not be found.
Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
Internal Server Error. The service encountered an unexpected error.
Service Unavailable. The service handling for this request cannot be reached at this time.
Gateway Timeout. The service gateway has reached its internal timeout.
No schema
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
type
string
required
URL to a document describing the error condition.
status
int
required
Transmission of the HTTP status code so that all information can be found in one place, but also to correct changes in the status code due to the use of proxy servers.
title
string
A short, human-readable title for the general error type; the title should not change for given types.
detail
string
A human-readable description of the specific error.
instance
string
This optional key may be present, with a unique URI for the specific error; this will often point to an error log for that specific response.
request_id
string
Correlation ID for the original request.
upvest-request-id
string
uuid
- Example
- "169ae4c7-ebd7-4041-94da-25369653eba7"
Was this page helpful?