I'm trying to call the people api through AJAX using jquery but the response doesnt seem to have a callback wrapper, which causes an error. here is some sample code:

 The call does seem to go through fine. Perhaps I have to change the callback? Thanks.

Hello,

I am trying to figure out how to update via API the Data Entry and Call view fields for a List.

Also what are corresponding fields in the people API?

Thanks.

I want to limit Leaderboard entries with respect to the tracking_code_slug in donations.
How to use this variable in Leaderboard template?

I am facing issues with http and https to https//www. is not redirect. http is redirecting https//www. but https is not redirect. Can anyone suggest me how we resolve it

Is there a way to get the ID for a people tag? So that when I rename a tag, I do not need to update the tag-people relationship. Thanks. 

When I hit the following url:

https://mysitename.nationbuilder.com/api/v1/sites/mysitename/pages/blog/attachments?access_token=mytoken

with the data:

{"attachment":{"filename":"flower-tiny.jpg","content_type":"image/jpeg","content":"/9j/4AAQSkZJRgABAQEASABIAAD/4QBARXhpZgAATU0AKgAAAAgAAYdpAAQA\nAAABAAAAGgAAAAAAAqACAAQAAAABAAAADKADAAQAAAABAAAADAAAAAD/2wBD\nAAEBAQEBAQEBAQEBAQEBAgMCAgICAgMCAwIDBAMEBAQDBAQEBQYFBAUGBQQE\nBQcGBgYHBwcHBAUICAgHCAYHBwf/2wBDAQEBAQIBAgMCAgMHBQQFBwcHBwcH\nBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwf/\nwAARCAAMAAwDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQF\nBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJx\nFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdI\nSUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKj\npKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx\n8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QA\ntREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHB\nCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldY\nWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmq\nsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6\n/9oADAMBAAIRAxEAPwD5/wD+CUf/AAS4/wCCd3xc/Ym+FHjPxj8L/G3xj+M/\nxomsLPVneyj1SXQJLuW4iF8EjdFtNNhGTJM25xhSc7QB/ON/wVV/Yag/Ys/b\nB8X/AAh8NadeaZ4TvbG31rSYGZ7oR2s7yxgLIwBdS0DkZ6ZK5O2vPf2SP+Cj\n37Uv7HnhrxV4Y+CnivSNM0/XIiu69sheSWYw5IgYsPLBbaxHIJRcjHB+VPjL\n8dPiv+0B8QNa+KHxd8a6x4y8ba8V+0Xlw+07V+7GqrhUUZOAAByT1JNeFjci\nxeT18HQyvHSlhGqlSsq8Yzqyqza5VCpHltSpWnGMbK8XC65ouT+yzzD08Vle\nAxNTESdSPNBQjTpwhbTmcmm5Tle1m0t5O+tj/9k=\n","updated_at":"2014-01-03T11:19:23-06:00"}}

I get a 500 error. Any way I can get this to work?

Thanks,

Steve

The create import endpoint does not offer the option to "Bypass webhooks" that is available when you perform a manual import.

1. Do imports initiated by via this endpoint the relevant webhooks (ie Person Created and Person Changed)?
2. Whatever the response to (1) it would be useful to control this behaviour from the API as it is via the manual interface.

I have imported a number of records via the API, which all have an email address and email_opt_in='Y', but the
records are being imported as PROSPECTS. Whereas http://nationbuilder.com/how_support_status_is_determined says:

"Records imported with:

  * support level = 1
  * support level = 2
  * email address and email opt-in = Y
  * mobile number and mobile opt-in = Y

will always be supporters."

Hi, 

It would be a huge help if paths and steps were included in the API.  Then we could automate much more of the importing and tracking that we do.  The feature has been out for a while and it seems intuitive that the feature would be included in the API.  Thanks so much!

Jenny Landon

Represent.Us

Issue :

The API for blog posts (https://apiexplorer.nationbuilder.com/nationbuilder#Blog-Posts) is only serving content excerpt and not the all page html content.

I suspect this is custom validation used across many API endpoints, but I specifically refer to the People Memberships endpoint (i.e. PUT to /people/:person_id/memberships) The validator rejects null values for expires_on, and will only accept strings. If we want to set expires_on to null, we must send it a non-date string. The API will reject "expires_on": null with an error, but will return "expires_on": null if the attribute sent is "expires_on": "". Further, the validator does not catch non-date strings. Sending "expires_on": "donuts" also results in the response "expires_on": null. Really, the output should match the input, and the date validator should check to see whether the attribute sent matches a valid value (i.e. ISO8601 date or null). Instead, the validator only rejects null values and the API translates any non-ISO8601 string to null.

The /donations/index endpoint has a maximum limit of 1000, not 100. https://nationbuilder.com/donations_api#index_endpoint

Right now the Donations Index endpoints returns all donations in a nation. It would be great if the API allowed the donor ID to be specified and then only return donations that have been made by that person.

It seems  a silly question to ask, but I do not quite understand how works your applications directory. I am looking at the directory and when I click on "Get started now" it just redirect to some web site. I thought it should start some sort of a dialog to generate an authorization request.

Is it possible to update multiple people in a single query? The only option I see is the /people/push endpoint, which accepts a single person.

I'm attempting to using AngularJS to access the API using JSONP (eg ?callback=JSON_CALLBACK, via this ST question) and I'm getting a 404 when hitting the /oauth/token endpoint.

Is JSONP enabled? If so, what might I be doing wrong here?

Relevant code below:

$http.jsonp('https://my_nation.nationbuilder.com/oauth/token?callback=JSON_CALLBACK', {
  method: 'POST',
  data: {
    client_id: 'CLIENT_ID',
    redirect_uri: 'http://localhost:9000',
    grant_type: 'authorization_code',
    client_secret: 'SECRET',
    code: 'CODE',
  }
 })

The Address resource documentation under the People API describes the country_code attribute as "country code". However, it appears the standard being used is ISO-3166-1 alpha-2 with upper-case characters. This is a requirement, entering a code which doesn't comply with this causes problems with NationBuilder's front-end. However, these requirements are not documented nor are they verified when an address resource is submitted.

We are making use of the /people/:person/notes API endpoint to log some notes about people, however in NationBuilder the note is coming "from" the person who created the app inside nation builder. For example "John Doe posted a private note about Jane Doe".
We dont want it to come from John Doe as he did not make the note, it came from the API.

a) How can we make the note come from the nation or simply be there and not be from someone?
or
b) How can we tell it to make the note from a "generic" person we created in the nation ?

Hi,

We're using the NB people API with PHP and the adoy/oauth2 library. Recently, whenever our site makes a PUT to /api/v1/people/push, we seem to be receiving a code 400 error with no message attached. 

Code:

$payload = array(
'person' => array(
'first_name' => $first_name,
'last_name' => $last_name,
'email' => $email,
'note' => 'Sign up from web form at ' . DB::now(),
'email_opt_in' => true
)
);

$api_url = $baseApiUrl . '/api/v1/people/push';

$response = $client->fetch($api_url, $payload, 'PUT', array('Content-type' => 'application/json', 'Accept' => 'application/json'));

The response comes through like this:

(

    [result] => 

    [code] => 400

    [content_type] => text/plain; charset=utf-8

)

Can anyone point me in the direction of what isn't right here?

Thanks,

Sam

Was building app that to search for for people with specific tags using api call : GET https://foobar.nationbuilder.com/api/v1/tags/tagname/people , but it returns code t=404(NOT FOUND) if tag tagname string contains space or "/".   This was not expected as spaces and / characters do not seem create search problems in other Tag searches on Nationbuilder outide of the API.

Used it quite a bit 2 years ago to great effect. Now it loops between choose site page and back to login page. Choosing a site seems to log me back out.

Still working for other people?

I am fetching a batch of people from the /people endpoint. I want the contacts' home_address and work_address values. My understanding is the /people endpoint is only capable of returning the primary_address and if I want to get the home_address, work_address, or other specific address, I would need to query the /people/:id endpoint. I'd rather query the /people endpoint just once rather than the /people/:id endpoint once for each and every contact. Is it in fact possible to fetch specific addresses with the /people endpoint?

Hello and apologies for the noob question. Using jQuery for API calls and I just can't seem to make a request that contains acceptable JSON data for the api. Using something like this:

Return message is always "I can only talk JSON..."

The new write endpoint has a few limitations that make it difficult to implement a good external donations solution and track the donations back in Nation Builder:

1) It does not allow donations to be assigned to an existing supporter, but instead creates a new user for every donation. Ideally we'd be able to pass a signup id in the initial payload, which would then assign the donations.

2) We have not been able to write any donation types other than CASH (such as Credit Card), which means they are recorded as "FAILED" and do not show up in reporting.

3) There are no options to write recurring donations and have them show up in /admin/signups/{id}/donations/recurring. This means we cannot effectively build an external recurring donations system and track that back through Nation Builder.

1-2 are priorities for us to be able to effectively use the API for our apps, any idea when these options may be supported?

Whenever we assign a membership to a person through API, it always shows "Dues amount" as "Free" under "Memberships" tab ("Edit" > "Memberships") on the person's profile. Is there a way to link a donation to the membership or just show an amount instead of "Free"?

Would love to see the API access lists

Hi folks, we'd like to add some JS actions—adding content to fields—to an NationBuilder form on submit before the form validation/send is triggered. However binding on the form submit handler triggers after the NationBuilder actions and the data is not captured.

Is there an elegant/sanctioned way to hook into the event dispatcher? Essentially I need a callback before the form submits though NationBuilder XHR channels. Someone has a gist of how to do this, but the timing of this isn't correct (form still submits).

Tags are supported when you GET an individual blog post, or POST/PUT a blog post, but not when you GET a blog's index.

Would be nice to be able to get lots of tags at once so they can be batch edited.

In short, it'd be great if the same fields for a GET on an individual post would be available for a GET of the blog's index.

I need to be able to make calls to the nationbuilder API inside of a nationbuilder theme on behalf of the current user. Is there a way to get an API token for the user inside of a template? I see there's _nbuild_token and _nbuild_session cookies, but those don't work as API access tokens. I don't see any liquid template variables that look like they would be useful in getting an access token for the current user. Alternatively, I can set up a REST server that can make calls to the nationbuilder API, and make requests to that from my template. However, I need some way to verify who the user is that's making that call. If I send the _nbuild_token and/or _nbuild_session from the cookies along with the REST request, is there some way to verify which user_id that token belongs to on the backend? I just need some way to validate that the user making the request is a logged-in user on my nationbuilder site so I know what they should or shouldn't have access to.

When running an import through the import API, if a single marital status field is wrong (eg is 'Inferred Married' or similar rather than 'Married' or 'M'), it rejects the entire import with a status 400 bad request. Is it possible to silently ignore than like with other fields?

After a credit card donation has been added as successful to a person, is there a method to update it to indicate that it was refunded or voided.

I tried setting canceled_at and failed_at to a date.  I also tried removing the value for succeeded_at (which leads to some unusual and misleading error messages)

The only method I have seen that "sort of" works, is to delete the donation.  But then there is no record of it at all.  Is deletion the only option I have?

I want to synchronise our civicrm membership records with NationBuilder. But the People API does not have any fields for membership level, start or end dates. 

Any chance in including every possible People field in the People API?

Which is the Top Mobile App Development Company in India?

When creating a new user via the API /people/push if only "name" is passed, nation builder ignores it (instead of parsing out first name/last name).

If I pass first_name/last_name then it does grab that, however the system were we are getting the data from does NOT have a first/last name - and I dont want to build the logic to guess at seperating them from the user input.

Also, its ignoring twitter_id
And I also found that you need to push "twitter_login" as the twitter handle, where the documenation says "twitter_name" as the handle.

If you're looking for a Ruby gem to help out your development efforts, ActionSprout's got one up on GitHub here.

I added people to my nation using the People API.

Checking their records shows they've been geocoded (mostly to an exact address). The only address for each person is the Registered Address, which is their Primary Address.

After adding to a list and viewing on the NEW turf cutter there are no people to view. Furthermore, when using the legacy turf cutter I _can_ see the people there.

Can you please explain to me what is going wrong? I'm concerned with relying on a legacy feature for our future use.

Many thanks,

Andre

According to http://nationbuilder.com/feature_comparison , it looks like the Developer API is only going to be available on plans starting at a thousand dollars a month now?  This effectively kills off the developer market entirely.

Was this intended?  The Developer API was one of the main reasons I came to NationBuilder, and I keep my community hosted here.  It's also been a huge reason for me to promote NationBuilder as an option amongst other non-profits, but the new pricing effectively destroys the potential of usage by most non-profits... 

Is there any form of the API being left in the lower tiered plans?

-Reed

new to NB, but trying to make something work on my 'nation' and this is one way i typically learn a new code base.  wazzup?

Is there a way to validate authorization token? For example, Google has such an endpoint https://www.googleapis.com/oauth2/v3/tokeninfo?id_token=MYTOKEN which returns token info if it is a valid one. It is doable with Facebook as well. graph.facebook.com/debug_token?input_token={token-to-inspect}&access_token={app-token-or-admin-token} Does Nation Builder provide similar endpoint? Thanks

When receiving the code parameter in our oauth callback page, can you also pass the nation slug and appname or client id with that code so we know which nation/app the request came from? This would allow us reuse code in many places on our side. I tried adding url parameters to my oauth callback url, but the app form would not allow it. Thanks!

Update: Nevermind. I can't put url params in the callback url, but I can put params in the redirect_uri to be passed back to me. Thanks!

The /person endpoint is generally quite strict on push, and it rejects invalid attributes on the object passed to it. For instance, fields which do not exist on the object or under custom fields will return a 400 with the error code "invalid_custom_field". However, the pseudo-attribute primary_address is accepted but no action is taken if it is passed. This should either be handled (i.e. a new address is created and assigned to the person), or the request should be rejected as invalid.

Is there anywhere we can find the url of page attachments in the snapshot?

Trying to upload a file with http://nationbuilder.com/page_attachments_api thru the oauth library, and getting error that the request uri is too long. I used encoder such as http://www.freeformatter.com/base64-encoder.html and got a ridiculously long string.

content -  Base 64 encoded representation of the file, with standard RFC 4648

Am I doing something wrong? Does "representation of the file" means an encoded version of the file? or it means url to the file or some other kind of representations?

Any helps/hints are appreciated.

We are exploring a scenario where payment processing would be done outside NationBuilder payment processor.

Any API functionality that can alert our system of a donation without processing it.

Kind Regards 

Would like to have the party and priority level fields added to the People API

I am trying to search people based on other criteria than those provided by the search api. (support_level to be more specific) I can't seem to find a way to do that. My nation has about 400 000 people in it. Even if I narrow using the tags, I still have to sort through around 80000 people.  With a limit of 100 results per page, that's still 800 requests. Am I missing something? I tried using the custom_value field of the search endpoint but it doesn't seem to work with preset fields in the database like support_level. 

Thanks

I'm using the Create endpoint, with the request straight from the documentation:

curl 'https://[nation].nationbuilder.com/api/v1/people?access_token=[token]' -X POST -H 'Content-Type: application/json' -d '{"person":{"email":"[email protected]","last_name":"Smith","first_name":"Bob","sex":"M","employer":"DexterLabs","party":"P","registered_address":{"state":"TX","country_code":"US"}}}'

I receive a full response body, but with

"registered_address":null

Any help appreciated.